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izTalk Server 2006 (BZ) is an integration server, based on .Net technologies. BizTalk Server 

helps you to integrate different applications across multiple organizations and perform B2B 
(business-to-business) transactions, using the Internet. It uses third party adapters to perform 
integrations with third party B2B systems. It enables companies to integrate and manage business 
processes by exchanging business documents, such as purchase orders and invoices, among 
distinct applications, within or across organizational boundaries. 


BZ 2006 exchanges information by sending and receiving messages in XML format among 
different organizations. This helps in centralizing the exchange of information from source to 
destination. 


This chapter introduces the latest version of BizTalk Server, known as Microsoft BizTalk Server 
2006 or simply BZ 2006, and describes its features in detail. It also explains the basic concepts 
related to BizTalk Server 2006; the various types of architecture of the server; and finally, how to 
install and configure BizTalk Server 2006. 


An Introduction to BizTalk Server 


Microsoft BizTalk Server, also known simply as "BizTalk", is a business process solution server. It 
provides the infrastructure and tools for building successful business-to-business solutions, 
business process automation, business process modeling, business-to-business communication 
and enterprise application. Although its targets mostly medium and large businesses, BizTalk has 
also become popular with small companies. 


A Business Process Management (BPM) server, BizTalk helps companies to automate and 
optimize business processes and provide powerful tools to design, develop, deploy and manage 
the business process. Using BizTalk, developers, IT professionals, and business analysts can 
easily build dynamic business processes spanning applications over the Internet. With BizTalk, 
companies need to use fewer resources to get their solutions to the market quickly in response to 
customer needs and competitive pressures. 


Microsoft BizTalk Server provides a powerful Web-based development and execution 
environment that integrates long-running business processes between businesses activities and 
transactions that used to take months to complete but now take justa few minutes. The BizTalk 
framework provides a standard gateway for sending and receiving documents across the Internet, 
as well as providing a range of services that ensure data integrity, delivery, and security. 


What is BizTalk Server 2006? ; 


BizTalk Server 2006 is the latest release of BizTalk Server developed by Microsoft. BZ 2006 
provides support for building solutions for business process and integration. BZ 2006 is the 
fourth version of BizTalk Server from Microsoft technology. Earlier versions of BZ are 2000, 
2002, and 2004. 


BZ 2006 is built on .NET framework 2.0 and its developer tools are hosted in Visual Studio 
2005. It uses SQL Server 2005 for storing database information. It is also supported on 64-bit 
Windows operating system, thereby taking the advantage of a larger memory and other benefits, 
such as security and compatibility. Some of the newly introduced features of BZ 2006 are as 
follows: 
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BZ 2006 provides better and easy support for deploying, monitoring, and managin 
applications. : 


BZ 2006 applications are considerably easier to install as compared to previous versions. 
BZ 2006 interface is simpler than that of BizTalk Server 2004. 


BZ 2006 provides improved capabilities and enhanced functions for Business Activity 
Monitoring (BAM). BAM is a collection of tools that allows you to create, deploy, and view 
information on running business processes. It gives you the status and results of the various 
operations, processes and transactions of your business, along well as the problem areas. 
This gives you the opportunity to take timely remedial action wherever needed, as soon as 
possible. 


Combining different systems into effective business processes is a very challenging task; 
however, this can be achieved very easily by using BZ 2006. Fig.Biz-1.1 illustrates the major 
components of BZ 2006. 


Business 
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Activity 
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Fig.Biz-1.1 


The figure shows how the BZ 2006 engine performs various business processes by sending and 


receiving messages among different components of BZ 2006. The BZ 2006 engine contains two 


Q 


major parts: 


A messaging part that is used for communicating with other applications. The messaging is 
done for different kinds of communications through adapters such as FILE, FTP, HTTP, 
POP3, and SMTP. The BZ 2006 engine supports various protocols and data formats, 
including Web services. 


The orchestration part, which is used to build graphically defined business processes 
through a sequence of diagrams. Using such diagrams makes a business process easier to 
understand than if it were explained in code. You can orchestrate customized business 
processes within organizations with the help of developers, information workers, and IT 
professionals who can work together to define, design, and deploy integrated solutions that 
work across applications, platforms, and organizations. 


Several other components can also be used with the BZ 2006 engine, such as: 
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Q 


Q) 


A Business Rules Engine is required to create rules that are used to determine an appropriate 
business action in .NET objects and XML documents. 


A Health and Activity Tracking (HAT) tool that enables developers and administrators to 
monitor and manage the server engine and orchestrations so that they run properly. It can 
also be used to solve business activity errors by those users who have no deep technical 
knowledge of BZ 2006. 


An Enterprise Single Sign-on (SSO) utility that provides the ability to map authentication 
information between Windows and non-Windows systems. With this component, the user 
can easily log on to multiple services with a single login. 


So now you are aware of the BZ 2006 and its components. Let’s move further to have a detailed 
overview of the features of BZ 2006. To know more about the HAT tool, please refer to 
Chapter 7. 


Features of BizTalk Server 2006 


BZ 2006 has several key enhancement features that build on the core architecture of BizTalk 
Server 2004. These feature deal with application-to-application, business-to-business, and 
business process automation. 


BZ 2006 comes with improvements in developer tools to simplify the development of complex 
applications. Some of the new and enhanced features of BZ 2006 are as follows: 


Q 


Simplified Setup Configuration: BZ 2006 provides a faster, easier and simplified installation 
wizard. The user can simply click the configuration wizard to configure BZ 2006. Some new 
and enhanced features available when setting up and configuring BZ 2006 are as follows: 


e Simplified one-computer installation. 


e BZ 2006 comes with component updater technology that checks for missing 
components during installation and installs them automatically from the Internet. 


e Supports flexible installation on multi-computers. 
e Simple upgradation from BZ 2004. 


e Can be installed on 32 and 64-bit computers, and automatic installation for 64-bit 
software on 64-bit operating systems. 


e Default configuration setup for new developers. 


Better Management and Operations Supports: The various enhancements to improve 
management and operations related processes help the IT administrator to be more 
productive in enterprise deployment. The new and enhanced features available in this area 
are: 


e BZ 2006 provides BizTalk Server 2006 Administration Console through which you can 
configure, deploy, manage and monitor your BZ 2006 applications easily. 


e BZ 2006 provides a task-based design for easy development and access to frequent and 
common tasks. 


e BZ 2006 provides the functionality of performing root-cause analysis by powerful and 
simple querying. 


Chapter 1: Getting Started with BizTalk Server 2006 


e BZ 2006 provides better and easier support for remote configuration and administration 
of multiple BZ 2006 groups. 


e BZ 2006 provides an enhanced error and event reporting tool (Health and Activity 
Tracking), which includes an exception message box. 


e BZ 2006 provides simplified deployment, better management, and easy troubleshooting 
for BizTalk Applications. 


Q Business Activity Monitoring (BAM) and Business Activity Services (BAS) Facilities: BAM 
allows you to create, deploy, and view information about running or previously run 
processes. BAM provides real time information about the status and results of various 
operations, processes, and transactions in the organization. BAS is basically a series of 
services that are hosted on Windows SharePoint Services to help the business user to work 
with a trading partner. Each trading partner that you want to set up will need an agreement 
in BAS. Once the agreements are created and deployed in BAS, you can handle business 
activities very easily with the trading partners. Windows SharePoint Services is used to 
create Web sites for information sharing and document collaboration benefits to increase 
team productivity. 


Q New and Enhanced Adapter: BZ 2006 comes with new tools and adapters such as the Flat 
File Schema Creation Wizard and the Windows SharePoint Services adapter respectively. 
The Flat File Schema Creation Wizard is discussed in Chapter 4. BZ 2006 provides many 
new and enhanced adapter features, such as: 


e New adapters such as the POP3 receive adapter, and Windows SharePoint Services 
adapters have been added in BZ 2006. 


e Enhanced adapters such as the Message Queuing adapier, the IBM MQSeries adapter, 
the File adapter, and the HTTP adapter have been updated in BZ 2006. 


After going through the features of the BZ 2006 let’s move further to have a clear understanding 
of the BizTalk Server Architecture. 


BizTalk Server Architecture 


The architecture of BZ 2006 is shown in Fig.Biz-1.2. As you can see from the figure, the 
Receiving Port on the left consisting of adapters and the End Point Manager (EPM). EPM is 
responsible for the communication using the messaging service in BZ 2006, whereas the Receive 
Pipeline in EPM receives XML documents using the BizTalk Adapters. The Receiving Port is 
responsible for bringing messages into BizTalk from a source system and storing them in the 
BizTalk MessageBox. BizTalk MessageBox also uses the Orchestration, which is the heart of BZ 
2006. It is used to process and retrieve messages, required for performing business transactions 
Any messages that are used by orchestrations are stored in the BizTalk MessageBox, from where 
they are retrieved and sent as and when required. 


The Send Port on the right side consists of adapters, the End Point Manager (EPM), and the Send 
Pipeline. The Send Pipeline is responsible for collecting outbound messages from the BizTalk 
MessageBox and transmitting them to the destination system. The Send Pipeline assembles, 
encodes, and encrypts messages into an XML document, and then sends them through the 
BizTalk adapter. 
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This is the common architecture of BZ 2006. Now that we have discussed the various 
components of BZ 2006, it is time to learn something about the various types of architecture in 
BZ 2006. BZ 2006 has four types of architectures based on different components of BZ. 


OQ Runtime Architecture 

OQ Management and Tracking Architecture 
Q Business Activity Service Architecture 
Q EDI and AS2 Architecture 


Let’s begin our discussion with BizTalk runtime architecture. 


Runtime Architecture 


Runtime architecture of BZ 2006 is built on a publish/subscribe architecture in which a message 
is published into the system, and then received by one or more active subscribers. This 
architecture is also known as content-based publish/subscribe architecture. In a content-based 
publish/subscribe model, subscribers specify the messages that they want to receive using a set 
of criteria about the message. This message is evaluated at the runtime and all of the active 
subscribers with matching subscriptions receive the message. 


Management and Tracking Architecture 


The Management and Tracking architecture of BZ 2006 includes components such as Business 
Activity Monitoring (BAM), planning for Health and Activity Tracking (HAT) and Record size in 
tracking database. Fig.Biz-1.3 depicts the BAM tool of Management and Tracking architecture of 
BZ 2006. Let’s look at the various components of Management and Tracking architecture in 
detail. 


1. Business Activity Monitoring (BAM): The BAM architecture is divided into four broad 
sections. These sections are Tools, Presentation, Processing and Database. Let’s briefly look 
at these sections. 


Chapter 1: Getting Started with BizTalk Server 2006 


Customer 
User 


BAM Interface 


Manager 


UOleyUBSald 


Tracking 
Profile 
Editor BAM SQL 


Management Notification 
Services 


[mee | | = | ~_ 


Fig.Biz-1.3 


Bulssa0014 


Tracking 
Profile 
Deploy 


aseqejeg 


Tools: The following tools are integrated with BAM and are used to design, develop, and 
deploy BizTalk solutions. 


BAM Manager: This is a deployment tool that allows the Excel tool of BAM to be 
deployed into an enterprise. 


Tracking Profile Editor: This tool enables BizTalk developers to map the data elements 
into BZ 2006 and implement these elements in orchestrations and messaging. 


Tracking Profile Deploy: This tool allows users to deploy new and updated schema 
based messages into the BAM infrastructure. 


Excel: This Excel tool provides a simple user interface that guides business analysts 
during the creation of business activities. 


Presentation: The presentation !ayer of BAM architecture consists of the following parts: 


BAM Portal: The BAM portal tool provides real-time, end-to-end visibility into a 
business process. It allows you to perform data searches and aggregate data on your 
business process. It is a Web-based tool that consists of a collection of ASP.NET 2.0 
pages. 

Excel: It provides a user interface that helps and guides business analysts during the 
creation of business activities in the organization. Excel serves as both a design tool for 
business analysts and a data consumption tool for business users. 


Custom User Interface: Developers can use this interface to create custom applications 
that display BAM data. 


Processing: The processing layer of BAM architecture consists of the following tools: 
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e BAM Management Web Service: This web service is used with BAM Portal to help 
clients get related business activities in the organization. 


e Event Bus: The BAM Event Bus tool processes the tracking data stored in a source 
database and persists that data in a query table format in the destination database. 


¢ SQL Notification Services: This tool generates and sends notification messages during 
the development and deployment of applications. For example, subscribers might 
express the following preferences: "Notify me when the stock price reaches Rs.150," or 
"Notify me when the price of stock in the database is updated." 


Q Database: The database tool is used to store the data and is connected with the processing 
layer. 

Now that you are familiar with BAM components of Management & Tracking architecture, let’s 

move on and learn something about the next component of Management & Tracking 

architecture: planning for Health and Activity Tracking. 


2. Planning for Health and Activity Tracking (HAT): HAT is a monitoring tool used to monitor 
the BZ 2006 application to solve the errors of your business activities. Here, you can decide 
and set the selected messages that you need to track during the planning stage because 
when you track all messages through HAT, it minimize the performance of your system. To 
know more about HAT, please refer to Chapter 7. 


The next component of Management and Tracking architecture is record size in tracking 
database. Let’s look at what this component does in detail. 


3. Record Size in Tracking Databases: The record size for various event records in the tracking 
databases is needed when you plan your hardware requirements for BizTalk. For example, to 
deploy a service, you need 1864+ symbolic information size (1 symbolic information is 
equal to an orchestration needing approximately 4000 bytes). A service to be successfully 
completed needs 252 bytes. Start and Call shapes (e these shapes will be discussed in 
Chapter 2) in an orchestration requires 120 bytes, and a minimum of 162 bytes is needed for 
incoming and outgoing messages. 


You are now familiar with the architecture of Management & Tracking, which is completely 
based on BAM. Next, we take up another architecture related to BAM, known as Business 
Activity architecture or BAS architecture. 


Business Activity Services Architecture 


In business processes, a business analyst may need to create a relationship with a new trading 
partner. This relationship may be based on, for example, the partner’s role, the business 
agreement between the two firms, and other aspects of this new association. A purchasing 
manager needs services that he can use to distribute the business activities required in a business 
process. These services are provided by Business Activity Services (BAS) in BZ 2006. 


The BAS architecture is shown in Fig.Biz-1.4. BAS provides a common user interface that 
enables the business user to use services such as Microsoft Windows SharePoint, Internet 
Explorer, Microsoft Excel, and Microsoft InfoPath. Behind the common user interface services, 
are two software components. These are Trading Partner Management and Business Process 
Configuration. 
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Internet Explorer, Microsoft Excel, 


Microsoft Infopath 
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Fig.Biz-1.4 

Q Trading Partner Management (TPM): The TPM component enables you to define user and 

organization profiles such as contacts, addresses and preferences. It is also used to define 

business partner relationships, such as buyer/seller, through business agreements. It connects 

you to your business partners to improve the movement of goods through your facilities and 
throughout the entire supply chain. 


The TPM partner stores information about trading relationships in TPM database, as show in 
Fig.Biz-1.4. It is also used to store agreements and the business profile of the trading partner. 


Q Business Process Configuration: The Business Process Configuration services allow business 
users to configure and manage orchestrations that implement the business process. Once the 
configurable business processes are available, business users can deploy them by using 
services such as Microsoft Windows SharePoint, Internet Explorer, Microsoft Excel, and 
Microsoft InfoPath to meet the needs of. the organization. Microsoft InfoPath is a part of 
Microsoft Office 2007 used to develop XML documents 

With this, we come to the last two architectures of BZ 2006, called Electronic Data Interchange 

(EDI) and Applicability Statement 2 or AS2 solution architectures, these are explained in the next 

section. 


EDI and AS2 Solution Architectures 


In BZ 2006, Electronic Data Interchange (EDI) is a process of exchanging business documents 
between companies, whereas Applicability Statement 2 (AS2) is an EDI specification used for 
data transport onto the Internet by using HTTP protocol. BZ 2006 uses EDI and AS2 solution 
architectures to provide supply-chain business processes to business partners. Let’s now look at 
these architectures in detail. 
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EDI Solution Architecture 


EDI or Electronic Data Interchange is a process by which business entities exchange data 
electronically. EDI messaging protocols ensure that data always arrives in a specified format. 
However, if the data is not in a specified format or is incorrect, it is automatically detected and 
reported to the business user. EDI uses the message syntax format and the standard format, 
including ANSI X12 format. The ANSI X12 format is used to develop uniform standards for inter- 
industry electronic interchange of business transactions. BZ 2006 processes EDI messages by 
using the Receive and Send pipelines that parse and serialize these messages. Fig.Biz-1.5 shows 
the exchange of EDI messages from Organization 1 to Organization 2. 


EDI messages 


Organization 1 


Fig.Biz-1.5 


When an EDI message is sent by BZ 2006, the EDI looks for the XML schema, validates the 
message, sends an acknowledgment (if needed), and serializes the EDI batch. The EDI assembler 
is used to perform the EDI message processing with the help of EDI Send Pipeline. 


AS2 Solution Architecture 
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AS2 or Applicability Statement 2 is a standard by which users transfer EDI data or other data, 
such as Extensible Marking Language (XML) documents over the Internet by using the HTTP or 
HTTPs protocol. When a user receives an AS2 message, he or she sends an acknowledgment 
message to the sender. AS2 can be used to transport EDI or non-EDI messages. For this reason, 
AS2 processing is designed and configured apart from EDI processing. Fig.Biz-1.6. shows the 
exchanging of AS2 messages through HTTP protocol from retailer to supplier. 


Internet 


Exchange 
AS2 
Messages 
through 
Flee 
Protocol 


Retailer 


Fig.Biz-1.6 


In BZ 2006, AS2 messaging is performed in MIME format of HTTP with AS2-specific headers. 
The nature of the message depends on whether the message is encrypted, signed, or compressed. 
If the message is signed, a signature wrapper message is added to the document payload; if the 
message is compressed, a compression wrapper message is added to the document payload; and 
if the message is encrypted, an encryption wrapper message is added to the document. BZ 2006 
uses the following AS2 pipelines to send and receive AS2 messages: 


Q AS2Receive Pipeline: This pipeline is used to processes messages received over AS2 when 
the messages are not encoded in EDI format. 
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Q AS2Send Pipeline: This pipeline is used to send messages over AS2 when the messages are 


not encoded in EDI format. 


Now that we have familiar with various architecture available in BZ 2006, it is time to move to 
the next stage and learn how to deploy BZ 2006. 


Deploying BizTalk Server 2006 


Microsoft BZ 2006 can be installed through simple, easy-to-follow steps. However, before 
installing the server, you need to first check whether you have the requisite hardware and 
software for beginning the installation process. ’Let’s look at these requirements. 


Hardware Requirements 
The minimum hardware needed to install BizTalk in 32-bit systems is as follows: 


Q) 


Oe) ee 


Processor: Intel Pentium processor with 1 GHz or higher for a single processor, 900 MHz or 
higher for a double processor and 700 MHz or higher for quad-processors. 


Memory: 1 GB of RAM. 
Hard disk: Minimum 6 GB of free hard disk space. 
Drive: CD-ROM or DVD-ROM. 


Monitor: Super VGA with a 1024 x 768 or higher resolution monitor supporting 256 colors 
or more. 


The minimum hardware needed for 64-bit systems is as follows: 


Q 


Cob 2 8 


Processor: AMD Opteron (AMD64), Intel XEON (EM64T), or compatible 1.7 GHz or higher 
processor recommended. 


Memory: 1 GB of RAM. 
Hard disk: Minimum 6 GB of free hard disk space. 
Drive: CD-ROM or DVD-ROM recommended. 


Monitor: Super VGA with a 1024 x 768 or higher resolution monitor supporting 256 colors 
or more. 


Let’s now look at the software requirements. 


Software Requirements 
The minimum software needed to install BZ 2006 on a single computer is as follows: 


Gl] Ny Me) ea | | 


O 


Microsoft IIS 6.0 or later versions. 

Microsoft Windows Server 2003 with Service Pack 1. 

Microsoft Office Excel 2003 and InfoPath 2003 with Service Pack 2. 
Microsoft Visual Studio 2005 with Microsoft Visual C# .NET. 

Microsoft SQL Server 2005 or Microsoft SQL Server 2000 with Service Pack 4. 


Microsoft SQL Server 2005 Analysis Services or Microsoft SQL Server 2000 Analysis Services 
with Service Pack 4. 

Microsoft SQL Server 2005 Notification Services or Microsoft SQL Server 2000 Notification 
Services 2.0 with Service Pack 1. 
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Q Microsoft Windows SharePoint Services 2.0 with Service Pack 2. If FrontPage Server 2002 
extensions are installed on IIS, uninstall them before installing Microsoft Window: 
SharePoint Services 2.0. 


The following operating systems can also be used with BZ 2006: 
Q Windows XP Professional with Service Pack 2. 

Q Windows 2000 Server with Service Pack 4 or above. 

Q Windows Server 2003 R2. 


Once the various hardware and software requirements are in place to install BZ 2006, you car 
go ahead with the installation process, as discussed in the next section. 


Installation of BizTalk Server 2006 


After analyzing the hardware and software requirements for installing BZ 2006, Let’s choose the 
edition of BZ 2006. It has editions such as: 


Q Enterprise Edition: It is required by customers with enterprise level requirements. 


Q = Standard Edition: It is required by customers with moderate business volume requirements 


Q Branch Edition: It is required for performing the RFID requirements. 
Q Developer Edition: It is required by developers for development and testing purpose. 


You can download the BizTalk Server 2006 from the Microsoft website and burn the same or 

the CD for installation. let’s go ahead and install the server on your system by the following 

steps: 

1. Insert the CD/DVD of BZ 2006. An auto-run menu will appear on your monitor screen, a: 
shown in Fig.Biz-1.7. 


2. Click the Install link from the auto-run menu to start the installation process (Fig.Biz-1.7). / 
Customer Information screen appears, as shown in Fig.Biz-1.8. 


oat 


Read the installation quide) 
Getting Started with BizTalk Serer (Video Tour, English) 
- 


t 


Install Microsoft BizTalk Server 2006 on this computer 


Reference 


Read the release notes 


BizTalk Server 2006 


Fig.Biz-1.7 
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3. In the Customer Information screen, enter the user name, name of your organization, and 


product key beside the User name, Organization, and Product key fields respectively 
(Fig.Biz-1.8). 


4. Now, click the Next button (Fig.Biz-1.8) to open the License Agreement screen, as shown in 
Fig .Biz-1.9. 


® Microsoft BizTalk Server 2006 It: | [ti el 


Customer Information 
Type your information. 


Enter your name and the name of your ofgarization, 


User name: Mata 
Diganization: Kogent Solution Inc 
Enter the product key for this pr that is on the lower section of your cettificate of authenticity. 


Fig.Biz-1.8 


5. After carefully reading the terms of the License Agreement, se/ect the radio button beside the 
Yes, | accept the terms of the license agreement option (Fig.Biz-1.9). 


6. Now, click the Next button (Fig.Biz-1.9) to open the Component Installation screen, as 
shown in Fig.Biz-1.10. 


DB Microsoft BizTalk Server 2006 Tnstalla 


License Agreement 
Please read the following license agreement carefully 


Agreement below. 


STO OP CRETE Dp CP EB OCTET ETO CET ACTS PEPE PTF 
Microsoft's ability is limited, at Microsoft's option, to: (i)in the case of the 
Software (a) repairing or replacing the Software, or (b)the cost of such repair or 


replacement, and (ii)in the case of support services (a) resupply of the services, or 
(b)the cost of having the sermices supplied again 


Should you have any questions concerning this EULA, or if you desire to contact 
Microsoft for any reason, please use the address information enclosed in this 
Software to contact the Microsoft subsidiary serving your country or visit Microsoft 
on the World Wide Web at http. / / www microsoft.com 


* ‘Yes. | accept the terme of the license agreement 


™ No. | do not accept the terms in the license agreement 


Help | < Back | 


Fig.Biz-1.9 


In the Components Installation screen, you will find all the components under the Available 
component box already tick marked and selected by default (Fig.Biz-1.10). 
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i 
/ 


Enter the location where you want to install BZ 2006, beside the Install to option 
(Fig.Biz-1.10). 
8. Now, click the Next button (Fig.Biz-1.10). This opens the Summary screen of the Installation 
Wizard, as shown in Fig.Biz-1.11. 

& Microsoft BizTalk Server 2006 Installation Wizard: Bas Xi 


Component Installation Se 
Select components 


Available camponents: Description 


M) Server Runtime 
] Base ED! Adapter 


VY) Portal Components 


M Business Activity Services 


M) Business Activity Monitoring 


MV] Human Worktlow Web Service 


Administration Toals 


Developer Tools and SDK Space allocation 
Additional Soattware ; 


HWW 


Total Space Required on C 237.94 MB 
>| Space available on C. 1.65 GB 


Browse. | 
Cancel 


C:\Program Files\Microsott BizTalk Server 2006\ 8 


7 ee Install to: 
Help | 


Fig.Biz-1.10 


9. The Summary screen provides a list of components of BZ 2006 selected by default in the 
previous step which the Installation Wizard will install in your system. Click the Install 
button to begin installing the components (Fig.Biz-1.11). You can click on the Back button 
(Fig.Biz-1.11) to go back the Component Installation screen and deselect the selected 
component that you don’t need to install. 


& Microsoft BizTalk Server 2006 Installation Wizard x| 
Summary ann 
Review campanents to be installed re 


Ta start the installation. click Install. To make changes. click Back 


The following components will be installed 


- Documentation 

- Base EDI Adapter 

- Server Runtime 

- Partal Campanents 

- Business Activity Services 

- Business Activity Manitaring 


- Human Workflow Web Service 

- Administration Tools 

- Developer Tools and SDK 

- Additional Software 

- Enterprise Single Sign-On Administration 

- Enterprise Single Sign-On Master Secret Server 


Help | < Back | 


Fig.Biz-1.11 
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The Installation Progress screen appears, as shown in Fig.Biz-1.12. This screen shows the 
progress of the installation process. The Next button (Fig.Biz-1.12) is deactivated. This button 
will be activated as soon as the installation progress is complete. 


microsoft BizTalk Server 2006 Installation Wizard — 


Installation Progress 
Installing Microsoft BizT alk Server 2006 


Whiting system registry vabies 


I 


Key..: Microsoft BizT ak. Hws. Core, Version=3.0.1.0, Culture=neutral. PublicKeyT oken=31bizetbad264e35 


Installation stages: Operations: 
“SES TGS PARES ee a ee rs 
~ Installing components &} Installing Microsoft BizT alk Server 2006 


&} Installing Microsoft BizT alk Server 2006 


Fig.Biz-1.12 


10. Click the Next button once the installation process is complete (Fig.Biz-1.12). The 
installation Completed screen appears, as shown in Fig.Biz-1.13. 


11. Click the Finish button in the Installation Completed screen (Fig.Biz-1.13). The Microsoft 
BizTalk Server 2006 Configuration screen appears, as shown in Fig.Biz-1.14. 


Microsoft BizTalk Server 2006 Installation Wizard _ ey 


Installation Completed 


You have successfully installed Microsoft BizT alk Server 2006 


A Logfile has been created in your temp directory 


¥ Launch BizT alk Server Configuration 


To close this wizard, click Finish 


Fig.Biz-1.13 


After successfully installing BZ 2006, the next step is to configure the server. This is taken up in 
the next section. 


15 


Developing BizTalk 2006 Applications in Simple Steps 


Configuring BizTalk Server 


Once we have installed BZ 2006, we have to configure the server. This can be done by either of 
the following methods: 


QBasic configuration 


Q Custom contiguration 


Basic configuration 


Basic configuration is used by beginner level developers to configure BZ 2006. To configure BZ 
2006 using the basic configuration method, undertake the following steps: 


1. In the Microsoft BizTalk Server 2006 Configuration screen, the Basic configuration radio 
button is selected by default, along with the name of SQL server beside the Database server 
name option. In this screen, under Service credential, type the username and password 
beside the User name and Password text boxes respectively, as shown in Fig.Biz-1.14. 


2. Next, click the Configure button (Fig.Biz-1.14). 


Sh Microsoft BizTalk Server Z 


Microsoft BizTalk Server 2006 Configuration 
Choose default or custom configuration, and then enter the database and service credential information. 


rs 


f* Basic configuration 
. Custom configuration 
[0 SoTe heh ese eee a —— SS SS SSS 


| You have selected basic configuration (recommended for first time users). 


| Use this option to configure the server with default settings, After you enter the default database name and credential 
account information, click Configure. 


' TF BizTalk was already configured on this machine or if the database server is not local, use custom configuration. 


a. 


aS 5 et eee es 
| Type the name of the computer where SQL Server is Type the user name and password for the account that 
installed, IF you select the basic configuration option, all the services will run under, IF you select the basic 
databases will be created on this server. IF you select configuration option, all services will run under this 
the custom configuration option, this value will be used as account. If you select the custom configuration option, 
the default value For all databases which you can later this value will be used as the default walue for all services 
customize, which you can later customize, 
a‘, 
wm, 
+ 
Database server name: User name: 
| BIZTALKSERVERO6\SQLEXPRESS jAdministrator Browse... 
| Password: | 
| eceee | 
| 


Fig.Biz-1.14 


The Summary screen appears with a list of components of BZ 2006 that you want to 
configure. Click the Configure button to automatically configure these components, as 
shown in Fig.Biz-1.15. 
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appears. Here, the Configuration Wizard automatically 
configures all necessary components, such as Group, Enterprise SSO, and BizTalk Runtime. A 
green tick mark indicates the successful completion of a component configuration while a red 
cross indicates failure, as shown in Fig.Biz-1.16. 


onfiligur ation Vi 


| 
mun 
me 
i 


Fig.Biz-1 
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When the configuration process is complete, a screen with a list of the components appears, as 
shown in Fig.Biz-1.17. In the figure, you can check the configuration result of all the 
components. The components that are successfully configured will have ‘Success’ against them 
under Configuration Result, while those that could not be configured will have ‘Failure’ marked 
against them. You can select the Launch Manual Configuration application option to manually 
configure the failed components (Fig.Biz-1.1 7). 
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Fig.Biz-1.17 


You now know how to configure the various components of BZ 2006 according to the Basic 
configuration method. If any of the components is not configured successfully through this 
method, these components can be configured using the Custom configuration method. 


Custom configuration 


The Custom configuration method allows you to configure BZ 2006 in advanced configuration 
mode. In this contiguration method, you can configure or unconfigure each component 
manually. To configure the various components of BizTalk Sever using the Custom configuration 


method, follow these steps: 


1. Select the radio button beside the Custom configuration option in the Microsoft BizTalk 


Server 2006 Configuration screen (Fig.Biz-1.14). 
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Next, click the Finish button to close the Basic Configuration wizard (Fig.Biz-1.17). 


2. Next, click the Configure button. A screen similar to the one shown in Fig.Biz-1.18 appears. 


Fig.Biz-1.18 
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You can use the screen shown in Fig.Biz-1.18 to configure the various components of BZ 2006 


manually. Now, you must be thinking about enabling enterprise SSO which helps in enabling 
Single Sign-On service for all BZ service. 


We will continue with the chapter and describe how to install the Enterprise Single Sign-On 
(SSO) component of BZ 2006 in the next section. 


Installing Enterprise Single Sign-on 


The Enterprise Single Sign-on (SSO) a component enables a user to authenticate the resources of 
multiple software systems in BZ 2006 with a single login. It provides capabilities for securely 
storing and transmitting user credentials across local and network boundaries. Enterprise SSO 
can be installed by the following steps: 


1. Run the BZ 2006 setup and then perform steps 1 to 7 of the ‘Installation of BizTalk Server’ 


section of this chapter. The Component Installation screen appears, as shown in 
Fig.Biz-1.19. 


& Microsoft BizTalk Server 2006 Installal = Xx! 


Component Installation 
Select components 


Available components: 
| V) Administration Tisels gt 
M) Developer $ 
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we cso | [ie] toes _| 
el 
Fig.Biz-1.19 


2. In the Component Installation screen, expand the Additional software node and tick mark 
the Enterprise Single Sign-On Administration and Enterprise Single Sign-On Master Secret 
Server options to install Enterprise SSO (Fig.Biz-1.19). These options are briefly described: 


e Enterprise Single Sign-On Administration: This option is used when you want to map 
and connect the Enterprise Single Sign-On Services in administration and client tools. It 
is used to create and manage applications and perform all the administration tasks that 
application administrators and users need through BZ 2006. 


e Enterprise Single Sign-On Master Secret Server: This option allows you to create the 
SSO database and acts as a Master Secret Server in the Single Sign-On System. The 
Master Secret Server is used to store the master secret (encryption key). This encryption 
key is used to encrypt and decrypt the data it stores in the SSO database. 


3. Now, perform steps 8-11 of the ‘Installation of BizTalk Server’ section of this chapter. 
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Once you have successfully installed the Enterprise Single Sign-On in your system, the next step 
is to run SSO by the following step: 


4. Click Start>Programs> Microsoft Enterprise Single Sign-On>SSO Administration. 
Next, we will learn to install another SSO component, called the SSO Client utility. 


Installation of SSO Client Utility 


The SSO Client utility allows end users to configure their client information in the SSO database. 

A self-extracting $SOClientInstall.exe file is used to install SSO Client Utility. To install SSO 

Client Utility, you must have one of the following: 

Q Microsoft Windows Server 2003. 

Q Microsoft Windows 2000 Server with Service Pack 4, or Windows XP Professional with 
Service Pack 1. 

Q_ .NET Framework 2.0. This version is necessary only if you are using the Ul-based SSO Client 
Utility. 

Now, to install the SSO Client utility, follow the steps given here: 


|. Double-click the self-extractor SSOClientinstall.exe file in your BZ 2006 installation CD. The 
WinZip Self-Extractor program appears on your screen. 


ho 


Then, select the folder where you want to unzip these files and click the Unzip 
button. The Microsoft Enterprise Single Sign-On Client Setup screen appears, as shown in 
Fig.Biz-1.20. 


{i Microsoft Enterprise-Single Sign : -(5) x! 
r fa Welcome to the Microsoft 
Enterprise Single Sign-On Client 


It is strongly recammended that you exit all Windows 
programs before running this Setup Program, 


Click Next to continue, 


WARNING; This program is protected by copyright law and 


international treaties, q 


Unauthorized reproduction or distribution of this program, 
ar any partion of it, may result in severe civil and criminal 
penalties, and will be prosecuted to the maximum extent 

passible under law, 


Fig.Biz-1.20 


3. In this screen, click the Next button (Fig.Biz-1.20). The User Information screen appears, as 
shown in Fig.Biz-1.21. 


20 


Chapter 1: Getting Started with BizTalk Server 2006 


User Information 
The Following information will personalize your installation, 


BizTalkSSOClient 


Organization; 


KogentSalutionInc 


Fig.Biz-1.21 


Enter your name and the name of your organization under the Full Name and Organization 
text boxes respectively (Fig.Biz1.21). 


Now, click the Next button (Fig.Biz-21). The Start Installation screen appears, as shown in 
Fig.Biz-1.22 


{= Microsoft Enterprise Single Si 


Start Installation 
4re you ready to begin the install? 


Click Install to begin or Back to change the installation information. 


Fig.Biz-1.22 


Click the Install button to begin the process of installing the SSO Client utility (Fig.Biz-1.22). 
Once the installation process is over, the Completing the Microsoft Enterprise Single Sign- 
On Client Wizard screen appears, as shown in Fig.Biz-1.23. 
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is Microsoft Enterp 


ea Completing the Microsoft 
Enterprise Single Sign-On 
Client Wizard. 


The wizard has successfully completed. To close the 
wizard, click Finish. 


Cancel | 


Fig.Biz-1.23 


7. Click the Finish button to close the SSO Client utility setup (Fig.Biz-1.23). 


After successful installation of the SSO Client utility, Click Start>Programs > Microsoft 
Enterprise Single Sign-On >SSO Client Utility to run the SSO Client Utility. 


Next, we will describe the various tools available in BizTalk Server 2006. These tools are helpful 
when you build the BizTalk application. 


Tools in BizTalk Server 2006 
There are various types of tools available in BZ 2006. Some of the important tools are 
Q BizTalk Schema Editor tool 
Orchestration tool 
Mapper tool 


a) 

Q) 

Q Pipeline tools 

Q BizTalk Explorer tool 


BizTalk Schema Editor Tool ' 


The BizTalk Schema Editor tool runs within the Microsoft Visual Studio 2005 environment. You 
can use this tool to create, edit and manage schemas within your application. BizTalk Schema 
Editor uses its own graphical system to represent the structure of messages, and uses the XML 
Schema Definition (XSD) language to store instances of messages and to exchange messages in 
specific format. For example, suppose you want to exchange flat files. To do this, BizTalk Server 
2006 processes the flat files and converts them to XML format. One of the most important 
reasons for translating all instance messages into XML format is to simplify the process of 
transforming a message from one structure into another. 
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Orchestration Tool 


An orchestration is a powerful and flexible tool used for representing business processes based 
on XLANG/s language. XLANG/s is a messaging language with some expression capabilities of 
C#. XLANG/s language is executed by orchestrations that perform business processes. Messages 
are sent and received by orchestrations through MessageBox, as shown in Fig.Biz-1.24. To know 
more about orchestrations, please refer to Chapter 2. An orchestration can be developed under 
Visual Studio 2005, which will be discussed in section ‘Adding an Orchestration’ of Chapter 3. 


Incoming Message Outgoing Message 
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Receive Location 


Send Location 
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Adapter 


Receive 
Adapter 


Receive Pipeline 


XML Message XML 
frst rj Message 
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Fig.Biz-1.24 


Mapper Tool 


The BizTalk Mapper tool is used to establish the relationship between an input and an output 
schema by using linking and functoids. A linking is when a data of a record or field is directly 
connected to items in another schema. Functoids mainly manipulate complex data, such as 
adding the value of two fields in the source schema, copying the result to the destination 
schema, converting a character to ASCII format and returning the average of a field in a 
repeating record. BizTalk Mapper stores maps in a file with a .btm extension. This file saves 
design information about the map, the locations of icons representing functoids, and the linking 
between schema items and functoids. 
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Fig.Biz-1.25 


Fig.Biz-1.25 shows how each field of source schema can be mapped to corresponding fields of 
the destination schema. It also shows how to translate and transform messages by converting 
them from one format to another format, such as converting a flat file into an XML file. To know 
more about the Mapper tool, please refer to the ‘Mapping the Message’ section of Chapter 4. 


Pipeline Tools 
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The pipeline tools (which include the Send and Receive pipelines) transform XML messages from 
source nodes to destination nodes and perform other data-specific actions, such as data 
encryption and decryption. The main tasks of the pipeline tools are as follows: 


Q They transform data of various formats to XML format and vice-versa. 


Q They decode and encode documents. 
Q They encrypt and decrypt documents. 
Q They sign the digital signature of documents for verification. 


Fig.Biz-1.24 shows the workflow of the pipelines involved in processing messages. The incoming 
messages first pass through the Receive Adapter. From there they go to the Receive Pipeline, 
where they are transformed to XML messages. After these XML messages are transmitted from the 
Receive Pipeline, they can be used by orchestrations and then sent to the Send Pipeline for the 
destination node as outgoing messages. 


Chapter 1: Getting Started with BizTalk Server 2006 


BizTalk Explorer Tool 


The BizTalk Explorer tool is a Microsoft Visual Studio 2005 tool that displays the contents of 
BizTalk Management database. It enables you to explore, configure, manage and reuse 
orchestrations as well as receive locations and send ports through a graphical interface in the 
Visual Studio 2005 development environment. The main tasks of the BizTalk Explorer tool are as 
follows: 

Q It enables you to view and manage the configuration details of your project. 

Q It is used in viewing databases and assemblies. 


Q It is used to make and edit ports, roles, and parties. 


Q It is used to deploy/undeploy business processes. 


BizTalk Management database is the central storage information used to store artifacts, such as 
orchestrations, receive locations, send ports, party, and so on. For more information on BizTalk 
Explorer tool, please refer to the ‘Using the BizTalk Explorer’ section of Chapter 4. 


With this, we come to the end of the chapter. We hope the chapter has served the purpose of 
familiarizing you with the basic features of BZ 2006. Next is a short summary of the chapter. 


Summary 


The chapter described the latest version of BizTalk Server, known as Microsoft BizTalk Server 
2006 along with its features. It dealt with the basic concepts and types of architecture of BZ 
2006, such as simple, runtime, and BAS architecture. Also discussed were the installation and 
configuration processes of BZ 2006 in simple steps, after which the chapter explained in depth 
the various tools available in the BZ 2006 server. 


In the next chapter, we will discuss the business process and orchestrations designer components 
that will help you to build the BizTalk application. 
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business process is a set of coordinated tasks and activities, conducted by both people anc 

equipments, which lead to accomplishing a specific organizational goal. Business proces: 
management (BP) is a systematic approach to improving these processes. BizTalk is a busines: 
process management (BPM) server that enables companies to automate and optimize busines: 
processes by exchanging business documents (for example, purchase orders and invoices 
between business applications within or across organizational boundaries. 


You can easily build and implement a business process through BizTalk Server 2006. For this 
you have to add various BizTalk components, such as orchestration, messaging, ports anc 
orchestration designer shapes. BizTalk orchestration is the brain of the BizTalk application. | 
enables you to design and implement business processes by simply dragging and dropping 
various orchestrations shapes available in the Orchestration designer tool. This chaptel 
introduces you to the various components that are involved in the making of a business process. 


Building a Business Process 


As already said, a business process is a collection of activities designed to produce a desired goa 
in an organization. It implies a strong emphasis on how the work is done within the 
organization. A business process is thus a specific ordering of work activities across time anc 
place, with a beginning, an end, and clearly defined inputs and outputs 


BizTalk Server 2006 builds a business process in a set of logically sequenced operations. Tc 
build a business process, you need to model the process by creating a business proces: 
orchestration using the orchestration designer shapes in BizTalk. A business proces: 
orchestration is the graphical representation of a business process. You can create a busines: 
process orchestration by using different shapes available in Orchestration designer shape: 
Toolbox. After creating a business process orchestration, the next task is to add ports, messages 
and orchestration designer shapes in the BizTalk project by using Microsoft Visual Studio 2005 
All BizTalk applications are developed under the Microsoft Visual Studio 2005 environment. 


Now that we know the meaning of a business process as well as the various components needec 
to implement the process through BizTalk Server 2006, we can go ahead and learn about the 
various parts of the BizTalk orchestration designer, which we are going to use to add variou: 
shapes required to build the business in our project. After this, we take you through the steps tc 
develop a simple business process in a BizTalk project. 


Understanding BizTalk Orchestration Designer Surface 


The orchestration designer surface is a graphical add-in that a developer can use to develop < 
BizTalk project. It is used for developing business processes of an organization and is hostec 
with Visual Studio 2005 to enable developers create a BizTalk orchestration. It also helps the 
business analysts model the processes, configure the messaging operations required in these 
processes and implement them. You can use the orchestration designer to create XLANC 
schedule drawings. These drawings are compiled to an XML-code schedule that can be run by 
an XLANG scheduler engine. XLANG is an XML _ business process language used fo 
orchestrating applications that coordinate the workflow among the various components of the 
BizTalk project as well as to help build business processes in BizTalk Server. 
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The BizTalk orchestration designer is shown in Fig.Biz-2.1. As can be seen from the figure, the 
orchestration designer is divided into the following parts: 


Q 
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Designer Shapes —P & vraion 


Orchestration 
Surface 


Output Pane 


Orchestration Surface: This is at the center of Visual Studio screen. It is here that shapes are 
dropped and the logic of the business process modeled. It is surrounded on either side by 
two port surfaces. 


Port Surface: The two port surfaces are used to drop port shapes to define the interface 
between orchestrations and messaging. Messages enter the orchestration through these ports. 
To know more about port shapes, please refer to the ‘Port shape’ section later in this chapter. 


Output pane: At the bottom of the orchestration designer is the Output pane, which is used 
to view error and warning messages generated during the building of the BizTalk project. 


Orchestration view: This view is in a tree-like structure whose nodes represent all the non- 
visual elements in an orchestration. These include messages, ports, variables (used to write 
BizTalk expressions), parameters (parameters are just like those that are passed in a function 
of any programming language. In BizTalk Server, you can specify the parameters of your 
orchestration, such as messages, variables, and ports) and port types declared in the 
orchestration. A developer can add and configure these components in this view during the 
development of the BizTalk project. 


Properties pane: This pane is used to set or change the names and other attributes of BizTalk 
components such as orchestration, ports and messages. 


Orchestration designer shapes (Toolbox): This Toolbox is visible on the left of the Microsoft 
Visual Studio 2005 environment. The components visible in the Toolbox include shapes 
used in constructing business process orchestrations. To use these shapes, simply drag them 
from the Toolbox onto the orchestration surface area. 
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Fig.Biz-2.1 


You are now familiar with the various parts of the BizTalk orchestration designer. You can use 
this knowledge to develop a simple business process by using the various orchestration designer 
shapes. However, to do this, we need to first create a BizTalk project. Let’s learn how to do this 


next. 
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Creating a BizTalk Business Process 


A BizTalk project contains different interrelated tasks of a business process required to run an 
organization. A business process is built by using the various components of the orchestration 
designer. However, before we can build business processes as well as add the various 
components needed to run them, we need to create a BizTalk project. A BizTalk project can be 


created by following these steps: 


1. Click Start>All Programs Microsoft Visual Studio 2005 Microsoft Visual Studio 2005 to 


open the Microsoft Visual Studio screen, as shown in Fig.Biz-2.2. 
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Fig.Biz-2.2 


2. Select File>New~ Project to open the New Project dialog box, as shown in Fig.Biz-2.3. 
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Fig.Biz-2.3 


3. Select BizTalk Projects and Empty BizTalk Server Project from the Project types and 


Templates panes respectively (Fig.Biz-2.3) 


4. Enter the name of the BizTalk project as OrchestratonProject beside the Name text box and 


click the OK button to create a BizTalk project, as shown in Fig.Biz-2.4. 
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Fig.Biz-2.4 


Right-click OrchestrationProject from Solution Explorer and select Add>New Item from the 
context menu to add an orchestration file. The Add New Item—OrchestrationProject dialog 
box appears, as shown in Fig.Biz-2.5. 


Enter the name of orchestration as Chapter2Orchestration.odx beside the Name text box 
(Fig. Biz-2.5). 
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Fig.Biz-2.5 


Now, click the Add button (Fig.Biz-2.5) to add the orchestration in the OrchestrationProject 
project, as shown in Fig.Biz-2.6. 
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Fig.Biz-2.6 


Thus, the new orchestration, Chapter2Orchestration.odx, is created in OrchestrationProject, a 
shown in Fig.Biz-2.6. To add shapes in the Chapter2Orchestration.odx. orchestration, simp| 
drag the shapes from the Toolbox and drop them in the area labeled ‘Drop a shape from th 
toolbox here’ (Fig.Biz-2.6). To know more about orchestration, please refer to the ‘Tools i 
BizTalk Server 2006’ section of Chapter 1 and the ‘Adding an Orchestration’ section c 
Chapter 3. 


Next, we will describe the various types of shapes available in orchestration designer (Toolbo» 
that are used to build business processes. 


Introducing Orchestration Designer Shapes 
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The orchestration designer shapes are the basic building blocks through which orchestration 
implement business processes. Each shape has a specific visual appearance representing 
specific task to build the business process. 


A business process is a set of actions that together meet some useful business need. A develope 
can use the orchestration designer in the BizTalk Server 2006 engine to define these action 
graphically. Rather than expressing the actions in a programming language, the orchestratio 
designer allows a developer to create an orchestration by simply connecting together a series « 
shapes in a logical way. 


When you add these shapes onto the orchestration surface, they connect with each other t 
build the business process. The left side of the Microsoft Visual Studio 2005 screen contains th 
Toolbox pane, as shown in Fig.Biz-27. This pane displays various orchestration designer shape 
that are used to build business process. All you have to do is simply drag these shapes from th 
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Toolbox and drop tnem in the orchestration surface. Fig.Biz-2.7 shows the Receive and Send 


shapes added in the orchestration surface. 
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You can use the orchestration designer shapes to design a business process orchestration. These 
shapes represent the operations required to be performed in the business process. The shapes 
available in Toolbox of Microsoft Visual Studio 2005 may be categorized as follows: 


Transferring control shapes, used in transferring the control from one shape to another. 
Messaging shapes, used in passing messages between applications in BizTalk Server. These 


used to construct or transform messages or alter the data within the 


orchestration. These include the Transform, Construct Message, and Message Assignment 


Q 
These include the Decide and Loop shapes. 
Q 
include the Send and Receive shapes. 
Q Data shapes, 
shapes. 
Q 


Error handling shapes, used to throw an exception or handle errors in the business process 


orchestration. These include the Throw Exception and Suspend shapes. 


In all, these broad categories include the following shapes: 


Q The Send Shape 

The Receive Shape 

The Port Shape 

The Call orchestration Shape 
The Start orchestration Shape 
The Loop Shape 

The Decide Shape 


The Construct Message Shape 


Coe 2) ea 2 oe 
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Q The Transform Shape 
O The Message Assignment Shape 


Let’s now discuss each of these shapes in detail. 


The Send Shape 


The Send shape enables you to send messages from a port in a business process orchestration. It 
also transmits the message to the BizTalk MessageBox and returns immediately to the next task 
of the business process. In BizTalk Server, you need to specify a message and port operation for 
a Send shape. The port operation helps to send messages to the Send shape. Fig.Biz-2.8 displays 
the Send shape. 
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As you can see in the figure, the Send shape contains a circle with a red exclamation mark smart 
tag, which helps to configure the Send shape. For more information on how to configure the 
Send shape, please refer to the ‘Adding receive/send shape’ section of Chapter 3. 


The Receive Shape 


The Receive shape enables you to receive a message from a port in a business process 
orchestration. Once a Receive shape has been dragged onto the orchestration surface, it must be 
configured by the exclamation mark smart tag. Fig.Biz-2.9 shows the Receive shape. 
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The figure shows the Receive_1 Receive shape that you need to connect to a port for receiving 
the message of a specific type such as XML, BizTalk schema and flat-file schema message. For 
more information on how to configure and specify a message type onto the Receive shape, 
please refer to the ‘Adding receive/send shapes’ section of Chapter 3. 
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The Port Shape 


The Port shape acts as a logical representation of the input/output location for a message to 
interface with an orchestration. The Port shape receives or sends messages in a business process 
orchestration. Each Port shape has a port type that defines which message is to be sent or 
received, the mode of communication pattern, such as one-way or request-response, and port 
binding. In port binding, you have to specify the direction of the communication from one 
location to another. You have to specify the direction of the communication of the message 
during the configuration of the Port shape by selecting either I’ll always be receiving messages 
on this port or Ill always be sending messages on this port from the port direction of 
communication drop-down menu. Fig.Biz-2.10 shows the Port shape. 
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Fig.Biz-2.10 


In Fig.Biz-2.10, the name of the port is Port_1, and Operation_1 is a set of operations to handle 
request or response messages, and the green arrow is used to connect with the Send or Receive 
shapes. For more information on how to add and configure the Port shape, please refer to the 
‘Adding Ports in the Project’ section of Chapter 3. 


The Call Orchestration Shape 


The Call Orchestration shape enables you to synchronously invoke other orchestrations of the 
business process. In a synchronous call, the Call Orchestration shape calls another business 
process orchestration only after first completing the ongoing business process orchestration. 
Fig.Biz-2.11 shows the Call Orchestration shape. 
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Fig.Biz-2.11 


The figure shows the Call Orchestration shape (CallOrchestration_1) that is used to call another 
orchestration. You can call other orchestrations within a BizTalk orchestration without sending a 
message outside an orchestration’s context. The Call Orchestration shape allows a parent 
orchestration (the main orchestration) to call a child orchestration (the orchestration inherited 
from the main orchestration) synchronously. Let’s suppose that you want to synchronously call 
an orchestration. To do this, you have to add the Calling Orchestration shape by following these 
steps: 

1. Drag a Call Orchestration shape from the Toolbox onto your orchestration surface, as 

shown encircled in Fig.Biz-2.12. 
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2. Click the exclamation mark on the CallOrchestration_1 shape and then select No Called 
Orchestration. Click to configure option. The Call Orchestration Configuration dialog box 
appears, as shown in Fig.Biz-2.13 
3. Click the down arrow beside the Select the orchestration you wish to call option and select 
BZApplication.BizTalk_Orchestration1 from the drop-down list of the Call Orchestration 
Configuration dialog box (Fig.Biz-2.13). 
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Fig.Biz-2.13 


4. Click the OK button to close the Call Orchestration Configuration dialog box and return to 
your orchestration. 
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Thus, the new orchestration, Orchestration_1, is called with the 
BZApplication.BizTalk_Orchestration1 Called Orchestration. When we call another, 
orchestration within BizTalk project, this orchestration must be available in your BizTalk project. 
It is necessary to first add the orchestration before calling it through the Call Orchestration shape. 


The Start Orchestration Shape 


The Start Orchestration shape asynchronously invokes other business process orchestrations of a 
business process. In an asynchronous call, the Start Orchestration shape calls another business 
process orchestration without waiting for the ongoing business process to be completed. When 
configuring the Start Orchestration shape, you must first specify the orchestration that you want 
to invoke by either double-clicking the Start Orchestration shape or by selecting the target 
orchestration via the Called Orchestration property from the Properties pane. Fig.Biz-2.14 
shows the Start Orchestration shape. 


Fig.Biz-2.14 


This figure shows the StartOrchestration_1 shape that is used to start another business process 
orchestration asynchronously. 


The Loop Shape 


The Loop shape is the simplest flow control shape that applies a while loop for performing an 
operation in a business process repeatedly. Each Loop shape executes the task repeatedly until 
the while condition specified on the Loop shape is false. You can specify a while loop condition 
by using the BizTalk Expression Editor. Fig.Biz-2.15 shows the Loop shape. 


BizTalk Expression Editor is a standard Visual Studio text editor, which you can use to write 
expressions to expand the capabilities of various orchestration designer shapes. These 
expressions are similar to those of any programming language. To know more about BizTalk 
Expression Editor, please refer to the ‘Adding the Decide shape’ section of Chapter 4. 


Fig.Biz2.15 
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Fig.Biz-2.15 shows the Loop shape that enables you to perform an operation related to a 
business process repeatedly in a while loop until a condition is false. The condition is in the form 
of a Boolean expression, which holds the value either true or false. 


The Decide Shape 


The Decide shape enables you to implement conditional branching in a business process 
orchestration. It always has at least two branches: a branch for the If statement and a branch for 
the Else statement. It is equivalent to an If...Then...Else statenient in standard programming 
language. Each branch of a Decide shape, except the Else branch, has a rule associated with it. 
You can use BizTalk Expression Editor to create a Boolean expression in the rule that is 
evaluated for the execution of that branch. Because the Else branch implies the negation of the 
Boolean expression in the previous branch, it does not have an expression associated with it. 
Fig.Biz-2.16 shows the Decide shape. 
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To know more about how to add the Decide shape, please refer to the ‘Adding the Decide Shape’ 
section of Chapter 4. 


The Construct Message Shape 
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The Construct Message shape creates a new message instance in a business process 
orchestration. It must contain either a Message Assignment shape or a Transform shape but no 
other shapes. BizTalk messages are immutable, which means that once the messages are created 
and persisted to the Messagebox database, they cannot be gpanged at any point. Fig.Biz-2.17 
shows the Construct Message shape. . 
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The figure shows the ConstructMessage_1 shape in which you can drag only the Message 
Assignment shape or the Transform shape from the Toolbox and drop them on the Drop a shape. 
from a toolbox here location. 


The Transform Shape 


The Transform shape maps a message to another message in the business process orchestration, 
thereby transforming the original message. The Transform shape maps one-to-many or many-to- 
one messages in BizTalk. You have to define one or more input messages, and one or more 
output messages, and an XSLT (Extensible Stylesheet Language Transformations) map to perform 
the transformation. XSLT maps are used with XSLT files to map data from one input file (such as 
XML schema) to other output file (such as flat file schema). Transform shapes are used only in 
constructing messages, and hence always appear inside a Construct Message shape. Fig.Biz-2.18 
shows the Transform shape. 
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This figure shows the Transfom_1 shape contained inside the ConstructMessage_1 shape. To 
know more about Transform shapes, please refer to the ‘Adding a Transform Shape’ section of 
Chapter 4. 


The Message Assignment Shape 


The Message Assignment shape, as the name suggests, are messages constructed from other 
messages. It is primarily used to assign an existing message to another message and perform 
modifications in it, if needed. It also enables messages to be created from .NET classes such as 
Xml documents. As already mentioned, messages are immutable, meaning that once the 
messages are assigned, they cannot be changed at any point. Fig.Biz-2.19 shows the Message 
Assignment shape. 
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The figure shows the MessageAssignment_1 shape that allows you to assign one message 
instance to another message instance. 


We hope that you are now familiar with the business process and understand the functions of the 


various orchestration designer shapes available in BizTalk Server 2006. This also concludes the 
chapter. A brief summary of this chapter follows next. 


Summary 


40 


This chapter defined a business process in the context of BizTalk. You also learned about the 
various surfaces in Visual Studio 2005 with respect to BizTalk Server 2006. Finally, the chapter 
described the function of the various types of orchestration designer shapes available in BizTalk 
Server 2006. 


In the next chapter, you will learn to develop a simple BizTalk application. 


Chapter 3 


Creating a 
Sample Biztalk 
Applications 


in this Chapter 


Selecting the BizTalk Project Type 
Adding an Orchestration 

Message Adding 

Adding Ports in the Project 


Assignment of Strong Naming 
to the Assembly 


Deploying the Project 
Accessing the Application in 
BizTalk Server 2006 


Developing BizTalk 2006 Applications in Simple Steps 


bs pe must be familiar with business processes and orchestrations by now. To perform a 
business process, an organization uses Custom applications, which cater to the need of the 
organization’s business. These custom applications can be developed by using BizTalk Server 
2006 and Microsoft Visual Studio 2005. 


In this chapter, we are going to develop a custom sample BizTalk application, which will show 
the communication of messages from one end to the other in an organization. This custom 
application will be developed by using Microsoft Visual Studio 2005. For this, you need to first 
create a BizTalk Project type in the Microsoft Visual Studio 2005. The next step is to add 
orchestrations, messages, and connecting ports to create a business process. While creating an 
application, you also need to provide the strong name to the project assembly file for its 
identification in the global cache. After the application is developed, it can be accessed by 
configuring it with either BizTalk Server 2006 Administrator Console or BizTalk Explorer. 


In this chapter, we will cover and discuss the entire process in simple steps, beginning by 
learning how to develop a custom sample BizTalk application project. 


Selecting the BizTalk Project Type 
To develop a BizTalk project, you need to select the BizTalk Project type in Microsoft Visual 
Studio 2005. BizTalk Project type can be selected by following these steps: 


1. Click Start>Programs> Microsoft Visual Studio 2005>Microsoft Visual Studio 2005 to 
open the Start Page of Microsoft Visual Studio window, as shown in Fig.Biz-3.1. 
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2. Select File>New Project on the Start Page of Microsoft Visual Studio window to open the 


New Project dialog box, as shown in Fig.Biz-3.2. 


3. Select BizTalk Projects from the Project types pane to open the BizTalk templates for 


creating the BizTalk application, as shown in Fig.Biz-3.2. 
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4. Select the Empty BizTalk Server Project from the Templates pane (Fig.Biz-3.2). 
5. Next, enter the name of BizTalk project as BZApplication in the Name textbox. 


6. Now, click the OK button to accept the settings (Fig.Biz-3.2). This opens the BZApplication - 


Microsoft Visual Studio window, as shown in Fig.Biz-3.3. 
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The BizTalk project development environment is now ready. The next step is to add ar 
orchestration in the BZApplication project. 


Adding an Orchestration 

Orchestration is the brain of BizTalk and is used to build business processes for you 

application. The main feature of orchestrations is that they enable you to write your logic it 

graphical format rather than in programming language. 

Orchestrations can be added in the BZApplication project by following these steps: 

1. Right-click the BZApplication project in the Solution Explorer (Fig.Biz-3.3) and selec 
Add New Item from the context menu to open the Add New Item — BZApplication dialogs 
box, as shown in Fig.Biz-3.4. 

2. In the Add New Item - BZApplication dialog box, select the Orchestration Files node fron 
the Categories pane and select BizTalk Orchestration from the Templates pane (Fig.Biz-3.4) 


3. Enter the name of the orchestration as BZApplicationOrchestration.odx in the Name tex 
box, (Fig.Biz-3.4). 
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Fig.Biz-3.4 

4. Now, click the Add button to add the BZApplicationOrchestration orchestration item to th 

BZApplication project (Fig.Biz-3.4). Clicking the Add button also opens the BZApplication - 

Microsoft Visual Studio screen, as shown in Fig.Biz-3.5. BZApplicationOrchestration is thu 
added to your BZApplication project. 
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Fig.Biz-3.5 
You are now familiar with the method of adding an orchestration to the BizTalk project. After 
adding an orchestration, we need to add a message to the BZApplication project. Messages act 
as a piece of information that is exchanged between organizations. We will discuss the process 
of adding a message to our BZApplication project in the following section. 


lessage Adding 


In BizTalk, messages are simply XML or flat files used for exchanging information among 
organizations. BizTalk exchanges XML data through the Send/Receive ports and Send/Receive 
locations. The Send/Receive locations are used by BizTalk for retrieving messages from one end 
and forwarding them to the other. BizTalk uses the Send/Receive ports for transferring the 
message from the receive location to the send (destination) location. For more information on the 
Send/Receive ports, please refer to the ‘Introducing Orchestration Designer Shapes’ section of 
Chapter 2. 

Messages can be added in BZApplicationOrchestration by following these steps: 

1. Right-click the Messages folder on the Orchestration View pane to open the context menu. 


2. Select the New Message option from the context menu to add a message to the 
BZApplication project. The Message_1 message is added to the Messages folder, shown 
encircled in Fig.Biz-3.6. 
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3. Change the properties of the Message_1 message from the Properties pane (Fig.Biz-3 
according to values mentioned in Table 3.1. 


~ ‘Table 3.1: Properties and values of Message_1 message 


Property Value 
Identifier BZApplicationMessage | 
Message Type System.Xml.XmlDocument (in the .Net Classes node) | 


After applying these message properties, a screen will appear, as shown in Fig.Biz-3) 
BZApplicatonMessage is thus added to your BZApplication project. 
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Let’s now learn how to add ports in the BZApplication project for sending and receiving 
messages. 


Adding Ports in the Project 


Ports are communication endpoints, which are used by BizTalk Server for sending or receiving 
messages. The port must be configured to a specific receive location for receiving the message 
and to a specific send location, which acts as a message destination location. There are logical 
and physical ports. Logical ports are required at the time of developing a BizTalk application in 
Microsoft Visual Studio 2005. 


Physical ports are required at the time of accessing the BizTalk application (developed in 

Microsoft Visual Studio 2005) in BizTalk Server. You need to define both these ports, as they 

need to be bound together to exchange messages. For more information on the binding of logical 

and physical ports, please refer to the ‘Performing the Binding of Logical and Physical Ports’ 

section further in this chapter. 

While defining a port, you need to define the Port type, which is either one-way or request- 

response. The one-way port type allows messages to be sent from one-way only whereas the 

request-response type allows sending of message and receiving their acknowledgement when 

the message has been send to the sender. 

Ports can handle different types of messages, such as XML file or flat file. Ports can be added in 

the BZApplicationOrchestration orchestration by following these steps: 

1. In the Orchestration View pane, right-click the Ports folder and select the New Port option 
from the context menu to add a new port named Port_1. You can see the newly added port 
(Port_1) encircled in Fig.Biz-3.8. 
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2. Now, right-click the Ports folder in the Orchestration View pane to add another port. 


In this project, we need two ports. One port will be used to send messages from the Send shape 
and the other port will be used to receive messages from receive shape. The send/receive shape 
will be discussed in the ‘Adding send/receive shape’ section of this chapter. 


3. After this, change the properties of Port_1 and Port_2 ports in the Properties pane 
(Fig.Biz-3.8) according to the values mentioned in the Table 3.2 and Table 3.3. 


Table 3.2: Properties for Port_1 port 
Property 
Identifier 
Port Type 


Communication Direction 


Value 
BZApplicationReceivePort 
Create new One-Way Type (in the Port Types node) 


Receive 


When you set the value of Create new One-Way Type as mentioned in Table 3.2, it is necessary 
to select the BZApplicationReceivePort port and set its properties as well (Fig.Biz-3.9). 
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Table 3.3: Properties for Port_2 port 
Property 
Identifier 
Port Type 


Communication Direction 


Value 

BZApplicationSendPort 

One-Way Type ((in the Port Types node) 
Send 


When you set the value as One-Way Type of port type property as mention in Table 3.3, it is 
necessary to select the BZApplicationSendPort port and set its properties in the Port Surface area 


(Fig.Biz-3.10) 


Now, the BZApplicationReceivePort port and BZApplicationSendPort port is added in the Ports 
node, you will be presented with a screen, as shown in Fig.Biz-3.9. In Fig.Biz-3.9, you can see 
that PortType_1 is also added in the Port Types node in the Orchestration View pane. 
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Now, we will define an Operation for the port type PortType_1. 


An operation tells us the tasks that need to be performed by ports. An operation is a part of each 
port type. An operation has the attributes, namely Request, Response, or both. These attributes 
are self-explanatory and convey their purpose quite clearly. An operation can be defined by 


following these steps: 


1. First, change the Identifier property of the PortType_1 Port type in the Properties pane to 
BZApplicationPortType (Fig.Biz-3.9). 
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2. Next, expand the BZApplicationPortType node to open the screen with the added 
Operation_1 operation, as shown in Fig.Biz-3.10. 
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3. Change the Identifier property of the Operation_1 operation in the Properties pane to 
BZApplicationOperation (Fig.Biz-3.10). 


4. Expand the BZApplicationOperation operation. This displays the new Request attribute 
(Fig.Biz-3.11). 


5. Select the Request attribute, and change Message Type property in the Properties pane to 
System.Xml.XmIlDocument (in the .NET Classes node)... 


As we have already mentioned that the port type is One-Way for BZApplicationSendPort, we 
don’t need to define another port type for BZApplicationSendPort; we will use the 
BZApplicationPortType port type by selecting the BZApplication.BZApplicationPortType value 
for port type property of BZApplicationSendPort. 


When you complete all these steps correctly, your screen will look like the one shown in 
Fig.Biz-3.11. 


50 


Chapter 3: Creating a Sample BizTalk Applications 


%< B2Application - Microsoft Visual’Studio, 


File Edit View Project Build Debug GizTalk Tools Window Community Help 


4) ~ eal > ley ol a & =-3 cs Development + NET - & ¥ | at 2 
ae BZApplicationOrchestration.odx* Start Page Pe Bi R 
cf | Port Surface « >» Port Surface 5 shia * 
= = & Orchestration Properties 
gp |] premenerrcerennnny 4 Orchestration Parameters 

|< BZ ApplicationR. ‘ 
Fs ee area | Drop a shape =) sy Ports f E 1 
@ : BZApplication from the toolbox perp zAppicationkecelvePort 
Request S Heli _g) BZApphcationSendPart 


7 Messages 


<j BZAppicahonMessage 


ep 


BZ ApplicationSen 
BZ Application 


Request & 


BZApplicationReceivePart Port 


fe] 24 

© BizTalk + 
Binding Specify later 
Communication Direction Receive 


Description 


Identifier BZApplicationReceiyePart 


a 


Binding 
Indicatés the binding type of the location this part is associated with. 


Solution Explorer “29 Class View | Properties 


rchestra 


aa 


Fig.Biz-3.11 
Now, let’s add the Send and Receive shapes to the orchestration for building the business 
process. 


Adding receive/send shapes 


The Receive/Send shapes enable you to receive/send messages from the Send/Receive ports in a 
business process orchestration. These receive/send shapes are BizTalk objects that are used to 
communicate with the Receive/Send ports for exchanging the message. The Receive and Send 
shapes can be added to BZApplicationOrchestration by following these steps: 

1. Drag the Receive and Send shapes (from the BizTalk Orchestrations components on the 


Toolbox) onto the Orchestration Surface area where the point labeled Drop a shape from 
the toolbox here is indicated (Fig.Biz-3.12). The area is shown encircled in Fig.Biz-3.12. 
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2. Change the properties of the Receive_1 and Send_1 shapes in the Properties pane according 
to values in Table 3.4 and Table 3.5. 


Table 3.4: Property Values for Receive_1 shape 


Property Value 

Activate True 

Message BZApplicationMessage 

Name BZApplicationReceiveShape 

Operation BZApplicationReceivePort.BZApplicationOperation.Request 
Table 3.5: Property Values for Send_1 shape ” » 

Property Value 

Message BZApplicationMessage 

Name BZApplicationSendShape 

Operation BZApplicationSendPort.BZApplicationOperation.Request 


After entering these above values, you will be presented with screen, as shown in Fig.Biz-3.13. 
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Your application is now ready with ports and different shapes for communication. It is time to 
deploy the BZApplication project. However, before deploying the BZApplication project, 
however, we must first strongly sign the assemblies involved in the project to give them unique 
identification. 


In the next section, we will see how to assign a strong name to the assembly. 


Assignment of Strong Naming to the Assembly 


In .NET framework, GAC (Global Assembly Cache) is a machine code cache that stores 
assemblies. These assemblies can be shared by multiple applications on the computer. That is 
why assemblies need to be strongly signed for their unique identification in the GAC. Assigning a 
strong name to the assemblies in BizTalk Server will make them easier to identify from GAC at 
the time of accessing the application from the BizTalk Server. 


Strong Name, also referred as "SN”, is a technology introduced with the .NET platform. A 
project's identity name consists of a simple text name, the version number, and the public key 
and the digital signature. All these are used to assign a strong name to an assembly. During the 
deployment process of the BizTalk project in Microsoft Visual Studio 2005, each assembly needs 
to be strongly signed for its unique identification in GAC. You can strongly sign your assemblies 
by associating the BizTalk project with a strong name assembly key file. BizTalk based projects 
need to be deployed in GAC. For this, .NET assemblies related to the project need to be strongly 
signed. 
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fools> Visual Studio 2005 Command Prompt. The Visual 


> 


years, as shown in Fig.Biz-3.14. 


SHONvIdd V yy 


Fig.Biz-3.14 
Enter the following command at the command prompt to generate the Key Pair, as shown in 


Z 
Fig.Biz-3.15., 


Sn.exe -k BZStrongNameKey.snk 


Key paix: vritten, to 


iG? N\Program Files\Mic 


Fig.Biz-3.15 


Now the strong name BZStrongNameKey.snk is created in your current directory. 
Next, you need to assign the strong name BZStrongNameKey.snk to your BZApplication project. 


This can be achieved by following these steps: 
Open the BZApplication project in Microsoft Visual Studio 2005, if it is closed. 


i 
Click Project>BZApplication Properties to open the BZApplication Property Pages dialog 


Z. 
box, as shown in Fig.Biz-3.16. 
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3. Select the Assembly tab under the Common Properties node on the BZApplication Property 
Pages dialog box (Fig.Biz-3.16). 


4. Scroll down in the right pane and give the path of the Key file as C:\BZStrongNameKey.snk 
in Assembly Key File property value under the Strong name section, as shown in 
Fig.Biz-3.16, 
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5. Click the OK button on the BZApplication Property Pages dialog box to accept the settings. 


We have stored the .SNK file in the C: drive after generating it. Check your location before 
assigning the strong key to your BizTalk project. Now, your BZApplication project is ready for 
deployment. We take up this topic in the next section. 


Deploying the Project 
Once you develop a BizTalk application, the next step is to deploy the project on BizTalk Server 
2006. You can deploy your project through Microsoft Visual Studio 2005. 
The BZApplication project can be deployed by following these steps: 


1. Select Build>Deploy BZApplication on the BZApplication - Microsoft Visual Studio 2005 
window. 


Once you deploy your project successfully, you will get a successfully deployment with zero (0) 
error message at the bottom of the output tab of Visual Studio. 

When you click the Deploy BZApplication menu option in Microsoft Visual Studio 2005, 
Microsoft Visual Studio 2005 automatically builds the project first and then deploys it. 

Now, it is time to access the BZApplication project in BizTalk Server 2006 in order to test it. This 
testing is required before running the application in the business environment. 
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Accessing the Application in BizTalk Server 2006 


Accessing the BizTalk application involves configuring your BizTalk application (developed in 
Microsoft Visual Studio 2005) for its working in BizTalk Server 2006. This can be done through 
BizTalk Server Administrator Console or BizTalk Explorer. For configuring the application in 
BizTalk Server, we need to create physical Send/Receive ports and bind them to logical ports 
(learned earlier). We will now show you how to configure the application with BizTalk Server 


Administration Console. 


Using the Administration Console 


BizTalk Server 2006 Administration Console is a tool used for administrating and configuring the 
BizTalk components including BizTalk based applications. The BZApplication project can be 


configured in BizTalk Server Administration Console by following these steps: 


ie 


De 


3 


the BizTalk Server 2006 Administration Console screen, as shown in Fig.Biz-3.17. 
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Fig.Biz-3.17 


Expand BizTalk Server 2006 Administration> BizTalk Group>Applications, to open the 


Applications node, as shown encircled in Fig.Biz-3.18. 
Double-click the BZApplication node in the Applications node to expand it (Fig.Biz-3.18). 
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By BizTalk Server 2006 Administration Console 
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Fig.Biz-3.18 


As you now have access to BZApplication project, let us move on to create physical 
Send/Receive ports and locations, which are required for configuring the application in BizTalk 
Server using the BizTalk Server 2006 Administration Console. These part is also require for 
exchanging message after binding of physical and logical ports. 


Creating a Physical Receive Port and Location 


BizTalk Server 2006 Administration Console helps in binding the logical ports with the physical 
ports. We usually do this at the time of configuring the application with BizTalk Server 2006 
Administration Console as this gives us the flexibility to change the source of incoming messages 
without recompiling the application in Visual Studio. However, before binding the ports, you 
need to define the send/receive physical ports and their locations. Let us see how to define the 
receive physical port and its location. This can be done by the following steps: 


1. Right-click the Receive Ports folder of the BZApplication node (refer to Fig.Biz-3.18) and 
2. Enter the value as BZApplicationKecelvePort in the Name textbox (Fig.B1z-3.19). 
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*J BzApplicationReceivePort - Receive Port Properties 
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Fig.Biz-3.19 


3. Click the OK button in Fig.Biz-3.19 to accept the settings and to return to BizTalk Server 
2006 Administration Console. 


lf the BZApplicationReceivePort Receive port is added after clicking the OK button, it means that 
the Receive Physical port is configured. Now, follow these steps to configure the Receive 
location: 


1. Right-click the Receive Location folder of BZApplication node (refer to Fig.Biz-3.18) and 
select New>One Way Receive Location from the context menu to open the Select a 
Receive Port dialog box , as shown in Fig.Biz-3.20. 


J Select a Receive Port 


Fig.Biz-3.20 


2. Select the BZApplicationReceivePort from the Select a Receive Port dialog box and click 
OK button to accept the settings and to open the Receive Location Properties dialog box. 
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3. Enter the information (mentioned in Table 3.6) in the Receive Location Properties dialog 
box, to have a dialog box as shown in Fig.Biz-3.21. 


Table 3.6: Receive location property information 


Property Value 

Name BZApplicationReceiveLocation 
Transport Type File 

Receive handler BizTalkServerApplication 
Receive pipeline PassThruReceive 


Pipelines are used for transforming messages at the time of message receiving and sending. In 
this example, we have used the PassThruReceive pipeline as we do not require message 
processing; this is required when message destination is known and no validation, encoding and 


disassembling is required. 
— 
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Receive pipeline: 
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Fig.Biz-3.21 
4. Click the Configure button on the Receive Location Properties dialog box to configure the 
FILE format and to open the FILE Transport Properties dialog box, as shown in Fig.Biz-3.22. 


5. Browse the Receive folder location from where the server will receive messages. In our case, 
the Receive folder location is C:\receive (Fig.Biz-3.22). 
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FILE Transport Properties 
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Becelve folder: 
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File shack: fam 
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> Network Failure 
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| Retry count: 3 
| Retry interval (min): [5 


Fig. Biz-3.22 


When you first open the FILE Transport Properties dialog box (Fig.Biz-3.22), it shows the Receive 
folder textbox as blank. In this chapter, we have not shown the default figure as it is not required. 


6. Click the OK button on the FILE Transport Properties dialog box to return to the Receive 
Location Properties dialog box. Before clicking the OK button, ensure that the File Mask 
textbox value is *.xml. 


7. Click the OK button on the Receive Location Properties dialog box (Fig.Biz-3.21) to close 
the dialog box and return to the BizTalk Server 2006 Administration Console window, as 
shown in Fig.Biz-3.23. 


Select the Receive Locations folder from the right pane of BizTalk Server 2006 Administrator 


Console if the BZApplicationReceiveLocation receive location is not displayed on your screen 
(Fig.Biz-3.23). 


By default, the receive location is disabled. To enable this location, right-click 
BZApplicationReceiveLocation (in the Receive Locations folder) from the right pane of BizTalk 
Server 2006 Administrator Console and select the Enable option from context menu to enable 
the BZApplicationReceiveLocation receive location (Fig.Biz-3.23). 
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Fig.Biz-3.23 


Now, after configuring the Receive location and port, it is time to configure the Send port and 
location. 


Creating a physical send port and location 


The Send port is used to send the XML file in the Receive folder (discussed earlier) to the 
destination mentioned in the configuration of Send port. 


A physical Send port can be created by the following steps: 


1. Right-click the Send Ports folder in the BZApplication node of BizTalk Server 2006 
Administrator Console (refer to Fig.Biz-3.18) to open the context menu. 


2. Select New>Static One-Way Sent Port option from the menu to open the Send Port 
Properties dialog box, as shown in Fig.Biz-3.24. 


3. Enter the information mentioned in Table 3.7, on the Send Port Properties dialog box 
(Fig.Biz-3.24). 


Table 3.7: Send Port Properties Value 


Property Value 

Name BZApplicationSendPort 
Transport Type File 

Send handler BizTalkServerApplication 
Send pipeline PassThruTransmit 
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The PassThruTransmit pipeline is required when no document processing is necessary before the 
message reaches the destination. 
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Fig.Biz-3.24 


4. Click the Configure button on the Send Port Properties dialog box, to configure the FILE 
format and to open the FILE Transport Properties dialog box. 


5. Browse the Destination folder location to where the server will send messages. In our case; 
the Destination folder location is C:\sent, as shown in Fig.Biz-3.25. 
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Fig.Biz-3.25 
When you first open the FILE Transport Properties dialog box, it shows the Destination foldef 
textbox as blank. In this chapter, we have not shown the default figure as it is not required. 


6. Click the OK button on the File Transport Properties dialog box to close the dialog box ana 
return to the Send Port Properties dialog box. 
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Before clicking the OK button, ensure that the File Name textbox value is %MessagelD%.xml. 
This is required to ensure that the messages are stored in xml format with the 
(YoMessagelD%.xml naming convention at the destination location mentioned for the Send port. 


7. Click the OK button on the Send Port Properties dialog box ((Fig.Biz-3.24) to return to 
BizTalk Server 2006 Administration Console, as shown in Fig.Biz-3.26 
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Fig.Biz-3.26 


Select the Send Ports folder from right side pane of BizTalk Server 2006 Administrator Console 
when the BZApplicationSendPort send port will not display as in Fig.Biz-3.26. 


By default, Send Ports is not started; its status is unenlisted in BizTalk Server 2006 Administration 
Console. To start this port, right-click the BZApplicationSendPort from the right pane of BizTalk 
Server 2006 Administrator Console and select the Start option from the context menu to start 
BZApplicationSendPort 


Now, after configuring the receive/send locations and ports, it is time to perform the binding of 
logical ports with physical ports. 


Performing the Binding of logical and Physical port 


Logical and physical ports need to be bound for smooth functioning of the business process. This 
is also required to ensure that the documents are transferred from one location to other without 
any error. 
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To bind logical and physical ports, you need to configure the Orchestration name¢ 
BZApplicationOrchestration, developed in Microsoft Visual Studio 2005 in BizTalk Server 2006 
Administration Console. Sona ie the application for Hi ae involves the following steps: 


1 r 2006 Administration Console td 


open thee context menu. | 


2. Select the Configure option from the context menu to open the Configure Application dialog 
box, as shown in Fig.Biz-3.27. 
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Fig.Biz-3.27 


3. Select BZApplicatonOrchestration from the left pane of the Configure Application dialog 
box to open BZApplication.BZApplicationorchestration in the right pane, as shown it) 
Fig.Biz-3.28. 


4. Select the Host value as BizTalkServerApplication from the Host drop-down list om 
BZApplication.BZApplicationorchestration right pane (Fig.Biz-3.28). 
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5. Select BZApplicationReceivePort from the Receive Ports drop-down list and 
BZApplicationSendPort from the Send Port/Send Port Groups drop-down list in 
BZApplication.BZApplicationorchestration right pane, as shown in Fig.Biz-3.29. 
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6. Click the OK button on the Configure Application dialog box to close the dialog box and to 
accept the settings. 

You can also add new physical Receive/Send ports and locations from the Configure Application 
dialog box in case you have not added them before configuring the application for binding. To 
do this, select the <New Receive Port...> option from the Receive Ports drop-down list and the 
< New Send Port...> option from the Send Port/Send Port Groups drop-down list. 

Now that your application is configured, it is time to test the application. The process of testing 
the application is covered in the next section. 


Testing the Application 
The application can be tested by following these steps: 
1. Right-click the BZApplication node on the BizTalk Server 2006 Administrator Console to 
open the context menu. 
2. Select the Start... option from the context menu to open the Start ‘BZApplication’ 
Application dialog box, as shown in Fig.Biz-3.30. 
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Fig.Biz-3.31 


After few second, check the file in the Destination folder, that 
big piz-3.22. 
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Fig.Biz-3.32 
In Fig.Biz-3.32, the file is delivered with the name {9B3224EF-F7D5-4F54-B2DB- 
FBAF9E91D0C5}.xml. While delivering the file, BizTalk changes the file name with the file name 
specified in the send port configuration (see Fig.Biz-3.25). 
This delivery ensures that your application is configured properly on BizTalk Server 2006 and is 
easily accessed by the server. 


After testing the application, you can stop the application by following these steps: 
1. Right-click the BZApplication node in BizTalk Server 2006 Administration Console and 


select the Stop option from the context menu to open the Stop ‘BZApplication’ Application 
dialog box, as shown in Fig.Biz-3.33. 
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Fig.Biz-3.33 
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The Stop ‘BZApplication’ Application dialog box has three options, namely: 


Q Partial Stop - Allow running instances: This option allows running instances to continue and 
disables the receive locations only. 


Q Partial Stop - Suspend running instances: This option suspends running instances and 
disables receive locations. It stops all orchestrations and send ports. 


Q Full Stop - Terminate instances. This option disables receive locations and unenlists 
orchestrations and send ports. It also undeploys policies. 


In this chapter, we are using the Full Stop — Terminate instances option as we are stopping the 
application. 


2. Select the radio button beside the Full Stop — Terminate instances option (Fig.Biz-3.33). 


3. Click the Stop button to stop the application and to return to BizTalk Server 2006 
Administration Console. 


4. Close the BizTalk Server 2006 Administration Console. 
Note 


You can also perform the task of configuring, binding and testing the BizTalk application by using the BizTalk Explorer in 
_ Microsoft Visual Studio 2005. BizTalk Explorer can be accessed by following these steps: 
_ 1. Qpenthe BizTalk project in Microsoft Visual Studio 2005. 
| 2.  Deploythe BizTalk project. 


3. Select View BizTalk Explorer to open BizTalk Explorer, as shown in Fig.Biz-3.34. 
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| 4. Expand the <COMPUTER NAME>\SQLEXPRESS.BizTalkMgmtDB.dbo node in the BizTalk Explorer, to perform the | 
binding of physical and logical ports. 
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| You can perform these steps for opening the BizTalk Explorer. To configure the BizTalk application through BizTalk 
_ Explorer, refer to ‘Using the BizTalk Explorer’ section of Chapter 4. 
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Now that the application is tested, you can use it for performing your business tasks. 
This concludes the chapter. A brief summary of the chapter follows next. 


Summary 


In this chapter, you have learned about creating a sample BizTalk application with Microsoft 
Visual Studio 2005. You have also learned how to run the application in BizTalk Server 2006 
with BizTalk Server Administration Console by developing the physical ports. In the end, you 
have learned how to configure the application for binding physical and logical ports. This is 
done for testing the application in BizTalk Server 2006. 


In the next chapter, we are going to develop another project by using BizTalk schemas. 
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n today’s scenario, organizations need to transfer messages as information to different 

locations electronically. This information may relate to the vendor-client relationship or it may 
be some internal data exchange requirement. This kind of information transfer can be done 
easily and efficiently by using BizTalk Server. You can use BizTalk’s predefined schema formats 
in XML for storing message information. However, you may sometimes need to use the custom 
XML formats to send and exchange messages. For this, BizTalk provides a functionality of 
creating your own schema format as per your custom requirement, which you can use for your 
XML message. BizTalk also has a feature to support flat files. You can use BizTalk to create flat 
file schemas, read flat files and send them from one location to another. 


To understand this concept better, let’s take an example of ABC restaurant, which has a number 
of branches at different locations. Customers come to these branches and place their orders. The 
branch managers will normally need to send this information along with other information 
related to the routine functioning of the branch periodically in XML format to their corporate 
office. However, they face a problem in filtering this information in terms of what is required to 
be handled at the managerial level and that related to customer orders. To resolve this, ABC 
restaurant decides to hire a developer to develop a custom BizTalk schema based application 
that will help save customer information in custom format along with all the information 
requested by the corporate office. The BizTalk application can then be used to automatically 
filter the information related to customer orders, thereby simplifying an otherwise laborious and 
time-consuming process and making it efficient. 


Schema is a World Wide Web Consortium (W3C) standard for defining the structure and content 
of Extensible Markup Language (XML) documents. You can define your own XML documents 
and the types of data in it. 


In this chapter, we are going to develop a BizTalk schema based project. The chapter thus begins 
by telling you by how to create a new project, as discussed in the previous chapter. This is 
followed by adding the schema to the project, validating the schema, and generating an instance 
of the schema file. This is required to check the schema file for errors. Finally, the chapter tells 
you how to deploy the project with schema based messages and run it on BizTalk Server. 


The chapter also shows you the same functionality in the flat file format, which is converted into 
flat file schema. This helps to convert flat files to XML messages. The user need not have any 
knowledge of XML to create message files for transmission. 


Let us now move forward and take the first step in creating an XML schema based project. 


Creating a New Schema Based Project 


To build a BizTalk schema based project, we have to first create an XML schema message that 
will be used to transfer XML documents from one location to another. For this, we have to 
develop an XML schema to define the structure of the message. You can build the XML schema 
within Visual Studio 2005 through the BizTalk Schema Editor. 


Before developing the BizTalk schema proiect., let's first discuss the kind of dafa that you want to 
thus be associated with a customer’s order in a restaurant or hotel. We can define the structure 
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| of this schema (which we will call a customer order schema) used in our project in the following 
way: 


}\ 


CustomerOrder 


CustomerName 


CustomerAddress1 


CustomerAddress2 


Sane 
CustomerCity 


= CustomerState 
CustomerZip 
CustomerContactPhone 
OrderedProductNumber 
OrderedProductQuantity 


OrderedProductPrice 


When you have determined the attributes (child fields) of the customer ordering process, such as 
name of the customer, his address, the price of the products and added them to XML schema, 
you can say this schema is a customer order schema. 


The first step of creating the BizTalk schema based project is to give the project a name. This can 
be done by following these steps: 


i. 
jag 
5. 


Start Visual Studio 2005. 

Select File>New Project on Visual Studio to open the New Project dialog box. 

Select BizTalk Projects from the Project types pane and Empty BizTalk Server Project from 
the Templates pane. 

Enter the project name as CustomerOrder beside the Name text box and click the OK button 
to create the BizTalk schema based project. 


To know more about creating a BizTalk project, please refer to the section ‘Selecting the Project 
Type’ in Chapter 3. 


Creating a schema based project involves the following steps: 


eT a et a 


Adding Schema to the Project 
Setting the Data Type 

Promoting a Node 

Validating a Schema in the Project 
Adding an Orchestration 

Adding the Schema to Messages 
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Q Adding Different Shapes to the Project 


We will discuss all these steps one by one in this chapter, beginning withadding a schema in our 


project, that is the CustomerOrder project. 


Adding Schema to the Project 


Schema is an XML file that contains the structure and content of XML documents. You have tc 
add a customer order schema according to hierarchy defined earlier in this chapter. Customer 


order schema can be added to the CustomerOrder project by following these steps: 


1. Right-click the CustomerOrder project in Solution Explorer to open the context menu an 
Select Add>New Item from the CustomerOrder context menu. The Add New Item - 
CustomerOrder dialog box appears, as shown in Fig.Biz-4.1 


AddNewlItem-CustomerOrder a oo. 21x! 


ao | 
Categories: Templates: 88 ee 


&) BizTalk Project Items Visual Stunie installed fenrgihakes 


>= cs Property Schema 


Es Flat File Schema 3) Flat File Schema Wizard 


Orchestration Files 
Map Files 

Pipeline Files 
Schema Files 

My Templates 


j ] Search Online Templates... 


| A new BizTalk schema file, 


Name: CustomerOrderSchema.xsd 


> Add - Cancel | 


Fig.Biz-4.1 


2. Select Schema Files from the Categories pane and Schema from the Templates pane, ¢ 


shown in Fig.Biz-4.1. 


3. Next, enter the name of the schema file as CustomerOrderSchema.xsd beside the Name te 


box (Fig.Biz-4.1). 


4. Now, click the Add button (Fig.Biz-4.1) to add the schema to your project, as shown i 


Fig.Biz-4.2. 
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@¢ CustomerOrder - Mictosolt Visual Studia), 7) 
Bile Edit View Project Build Debug BizTalk Tools Windows Community Help 


Develo, Fete ~ .NET 


http //schemas microsoft com/Biz Talk /2003 | Advanced 
http //CustomerO Inder CustomerOrderSchema ! Attribute FormDefault (Default) 
BlockDefault (Default) 
Elernent FormDefault (Default) 
FinalDef sult (Default) 


(Collection) 
Schema Editor Extensions 
a BizTalk 
CodeList Database 


Promote Properties (Collection) 


General 


4 Sechinas Acaunestr 


Target Namespace http: //CustomerOrder, CustomerOrdel 
'B Reference 
Document Type 
; 1 nent Version 
r| Envelope (Default) 
Ci ESE RUA eae NUN Nese 1) Receipt (Default) 
poy xSD. ha | Root Reference (Default) 


Turn off auto refresh } Schema Type (Default) 


Specification Name 


andard (Default) 
Standard Version 


| Attribute FormDefaut 
|| Describes how the attributes will appear in the instance. Default value is 
‘Unqualified’, 


Fig.Biz-4.2 
5. Right-click the Root node of CustomerOrderSchema.xsd, and Se/ect the Rename option 
from the context menu. Now, rename the name Root as OrderService. 
We will add the various child field elements under the OrderService root node. 


Thus, the CustomerOrderSchema schema is added to the CustomerOrder project. Now it is time 
to insert the child field elements in the OrderService root node. A child field element is an XML 
element that describes items or data in string or number format. Some of the child field elements 
of our OrderService are CustomerName, CustomerAddress1, CustomerAddress2, and so on. The 
child field elements can be added in the OrderService root node of our project by following 
these steps: 

1. Right-click the OrderService node and Select Insert Schema Node>Child Field Element 

from the context menu. A Field node appears under the OrderService node. 


2. Right-click the Field node and Select the Rename option from the context menu. Rename 
this field as CustomerName, as shown in Fig.Biz-4.3. 


3. Now the CustomerName field is added to the OrderService root node. Next, repeat steps 1 
and 2 to add the following child fields to the OrderService root node: 


e CustomerAddress1 
e CustomerAddress2 


e CustomerCity 
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e CustomerState 

e CustomerZip 

e CustomerContactPhone 
e OrderedProductNumber 
e OrderedProductQuantity 


e OrderedProductPrice 
Once you have added all these child fields to the OrderService root node, your screen wil 
appear as shown in Fig.Biz-4.3. 


Se) 
= 18) X)) 


3 CustomerOrder -- Microsoft Visual Studio =— 
File Edit View Project Build Debug BizTalk Tools Window Community Help 


Development + .NET 


Eee 
: > CustomerName 
G} CustomerAddress1 


> 

G) CustomerAddress2 Attribute FormDefault (Default) 
S} CustomerCity BlockDefault (Default) 
©] CustomerState Element FormDefault (Default) 
GI CustomerZip FinalDefault (Default) 
S) CustomerContactPhone Imports (Collection) 


G) OrderedProductN umber 
| OnderedProductGuantity 
) OrderedProductPrice 


Schema Editor Extensions 


BizTalk 


Fs tly ap Ui 
ie —————E === 


e CodeList Database 
Promote Properties (Collection) 
General 
ema : i Adinristr 
Target Namespace http: een [a CustomerOrdeds 
Reference 


Document Type 

Document Version 

En\ elope (Default) 
Receipt (Default) 
Root Reference (Default) 
Schema Type (Default) 
Specification Name 

Standard (Default) 


| Show eupet from: 


Standard Version 


General 


= erage eae ee EE 7 : eee 
Ready bi 


Fig.Biz-4.3 


Figure Fig.Biz-4.3 shows the CustomerOrderSchema schema with the root node OrderServici 
which contains child fields such as CustomerName, CustomerAddress1, CustomerAddress‘: 
CustomerCity, CustomerState and CustomerZip. After adding the child fields in the OrderServid 
schema, the next task is to change the data type of the OrderedProductQuantity ari 
OrderedProductPrice child fields in the OrderService schema. 
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‘etting the Data Type 


\ When you have added all the child fields of the OrderService root node, the next task is to 
change the data type of the OrderedProductQuantity and OrderedProductPrice child fields 
| from string data type (which is assigned by default) to number data type. This is required since 
‘we will be performing mathematical operations in them. We can change the data type of these 
' two child fields by the following steps: 


| 1. Select CustomerOrderSchema.xsd in Solution Explorer to open the OrderService schema, as 
shown in Fig.Biz-4.4. 


#%CustomerOrder = Microsoft Visual Studia 
Project Build Debug BizTalk Tools Window Community Help 


- Gl- 


ig <Schem a Zz 
Ei} OrderService <a version="1 0" encodings u-16" 7> Ee 
SG] CustamerName é . ie pea) CustomerOrder 
] CustomerAddress1 ‘ = http _//CustomerOrder PropertySchema Property: //{'' (3) References 
aiuctomemdcres? ra http-//schemas microsoft com/Piz Talk/2003' t | 5 : 
a = "7 http: //CustomerOrder CustomerOrderSchema Ht eq CustomerOrderFlatFile.xsd 
at pe ee CustomerOrd: é) CustomerOrderMap.btm 
iB &) CustomerOrderOrchestration,adx | 
=) CustomerOrderSchema, xsd 
A CustomerOrderSendPipeline. btp 
4Q PropertySchema,xsd 


SS} CustomerCity 

S) CustomerState 

3} CustomerZip 

‘S] CustomerContactPhone 
‘S| OrderedProductNumber 
5] OrderedProductQuantity 


g OrderedPraductPrice 


sao 


Task fs Output f SiN) 


Fig.Biz-4.4 


2. Right-click the OrderedProductQuantity child field from the OrderService node and Select 
the Properties option from context menu (Fig.Biz-4.4). The Properties window appears, as 
shown in Fig.Biz-4.5. 


3. In the Properties window, change xs:string to xs:int in Data Type drop-down list under the 
General section (Fig.Biz-4.5). 
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OrderedProductQuantity Element Field ¥ 


[2 

© Advanced 
Base Data Type 
Derived By (Default) 


Fixed 
Form (Default) 
Nillable False 

© BizTalk 


Notes 
Gi General 


Data Type =. = = xszint 


Default Value 


fee 


Max Occurs 


Min Occurs 


Node Name OrderedProductQuantity 


Dave ne ee, 1 cee a ae 
Data Type of the Mode 


Fig.Biz-4.5 


4. Similarly to change the data type of the OrderedProductPrice child field, Right-click 
OrderedProductPrice and Select the Properties option from the context menu to open the 


Properties window. 


5. In the Properties window, change xs:string to xs:decimal in Data Type drop-down list under 
the General section (Fig.Biz-4.5). Your completed schema appears as shown in Fig.Biz-4.6. 


ustomenSddiess1 


Hee Jaw 3.079/2001/XML Schema 
OrderService 


<j CustomerContactPhone H CustomerName 
©) OrderedProductNumber 

NB OrderedProduct ef x sané= CustomerAddress 1 
©) OrderedProd. e = Bie ae 


5= CustomerState 


== CustomerZip Wwea= sting 
a= CustomerContactitine 


e= OrderedProduct Number 


xsam” (+ 
ent came= OrderedProduct Price 
xs.decimal 


12} SD ig 


Turn off auto refresh 


Fig.Biz-4.6 


http //schemas microsoft com/BizTalke/2003 
‘/CustomerOrder CustomerOrder Schema 
e= ‘http-//CustomerOrder CustomerOrderSchema 


Now that we have assigned the appropriate data types to the child fields of our project, the next 
task is to promote the nodes (the OrderedProductQuantity and OrderedProductPrice nodes in 
our case) that are used to reference a specific value within a message instance. This is taken up 


in the next section. 
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Promoting a Node 


section of this chapter. 


Ty Open 


Microsoft Visual Studio 


od Visual Studio will create a property schema that contains all your quick promotians, Do you want te add the property 


| 
| ‘sul schema to your project? 
| 
| 


CustomerOrderSchema.xsd in 
CustomerOrderSchema.xsd. (Fig.Biz-4.4) 


2. Right-click OrderedProductQuantity and Se/ect Promote>Quick Promotion from the 
context menu to promote OrderedProductQuantity (Fig.Biz-4.6.) A Microsoft Visual Studio 
dialog box appears, as shown in Fig.Biz-4.7. 


Promoting a node is a mechanism to reference a specific value within a message instance and 
| make it accessible to the BizTalk Server components, such as orchestrations and messages. 
Promoting a node in the schema makes the data in the schema available to an orchestration or a 
message. We have to promote only the OrderedProductQuantity and OrderedProductPrice, 
child fields, whose values we will check using the Decide shape and make them accessible with 
a message. To know how to check these two nodes, please refer to the ‘Adding a Decide shape’ 


Promoting is also used to check that the values of the OrderedProductQuantity and 
OrderedProductPrice nodes are not less than 0 (zero) when the order placed by a customer is 
entered. To ensure this, follow these steps: 


Solution Explorer by selecting 


Fig.Biz-4.7 


3. Click the OK button to accept the changes in the OrderedProductQuantity node 


(Fig.Biz-4.7). 


4. Similarly, follow the same steps to promote the OrderProductPrice node and you will get a 


screen as shown in Fig.Biz-4.8. 
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Fig.Biz-4.8 
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You have just learned to promote the OrderedProductQuantity and OrderProductPrice nodes in 
simple steps in the previous section. The next step in our project is to validate the schema. This 
is the subject of cur next topic. 


Validating a Schema in the Project 


Schema files used in business processes need to be validated to ensure that they maintain 
consistency in their XML structure. The is done to validate the instance message so that the 
specified schema is in correct format, which means that each child field in schema must open 
with a tag and close with a tag. For example, in the following code of schema, the value of 
CustomerName “CustomerName_0” is opened and closed with the <CustomerName> tag. 


<nsQ:OrderService xmins:ns0="http: //Customer.CustomerSchema"> 
<CustomerName>CustomerName_0</CustomerName> 
<CustomerAddressi>CustomerAddressl_ 0</CustomerAddressi> 
<CustomerAddress2>CustomerAddress2_0</CustomerAddress2> 
</nsQ:OrderService> 


The CustomerOrderSchema.xsd schema file must be validated before using it in our project. You 

can validate the schema by following these steps: 

1. Right-click the CustomerOrderSchema.xsd node and Se/ect the Properties option from the 
context menu in Solution Explorer. The CustomerOrderSchema.xsd Property Pages dialog 
box appears, as shown in figure Fiz.Biz-4.9. 


| Speciy input instance Rename for instance validation. 
i my, 
i ee ee 
i ad OK | Cancel | Acc | 


Fiz.Biz-4.9 


i) 


To display the validated output XML file, enter the XML filename C:\OrderService.xml 
beside Output Instance Filename and Input Instance Filename respectively, as shown in 
Fig.Biz-4.9. 

Now, click the OK button to close the CustomerOrderSchema.xsd Property Pages dialog 
box. 


Od 


4. Next, Right-click the CustomerOrderSchema.xsd node in Solution Explorer and Select the 
Validate Schema option from context menu to validate the schema. 
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You will see a validated instance success message in the Output pane, as shown in Fig.Biz-4.10_ 
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Fig.Biz-4.10 


Now that we have validated the CustomerOrderSchema.xsd schema file in the CustomerOrder 
project, the next step is to add an orchestration in the project to build the business process with 
the help of various orchestration designer shapes. 


Adding an Orchestration 
An orchestration can be added in the CustomerOrder project by following these steps: 


5. 


hm 


Right-click the CustomerOrder project in Solution Explorer and Se/ect the Add>Newltem 
from the context menu to open the Add New Item — CustomerOrder dialog box. 


Select the Orchestration Files node in the Categories pane and Select the BizTalk 
Orchestration node in the Templates pane in the Add New Item — CustomerOrder dialog 
box. Also, enter the name of the orchestration as CustomerOrderOrchestration.odx beside 
in the Name text box. 


Now, click the Add button to add the CustomerOrderOrchestration orchestration item to 
the CustomerOrder project. 


For more information on how to add orchestrations, please refer to the ‘Adding an Orchestration’ 
section in Chapter 3. 
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Now that the CustomerOrderOrchestration orchestration and the BizTalk OrderService schema 
have been added to the CustomerOrder project, it is time to use the OrderService schema in the 


message because the BizTalk project communicates through messages and these messages have 
to be in XML or flat file format. 


Adding the Schema to Messages 


As discussed earlier, that BizTalk project communicates with messages and these messages 
should be in XML format. In this project, we have already developed the OrderService schema 
(XML document), which we can now use in the message. We now need to add the OrderService 
schema to the message in the CustomerOrder project. This can be done by the following steps: 


1. Right-click the Messages folder on Orchestration View. In addition, Select the New Message 


option from the context menu to add a message to the CustomerOrder project. Doing this 
adds the Message_1 message to the Message folder. 


2. Change the properties of Message_1 according to values mentioned in Table 4.1. 


Table 4.1: Properties and values of Message_1 message 


Property Value 
Identifier Customer0OrderMessage 
Message Type CustomerOrder.CustomerOrderSchema (in the Schema node) 


After applying these properties, the CustomerOrderMessage message is added in the Messages 
folder, as shown in Fig.Biz-4.11. 
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Fig.Biz-4.11 


82 


Chapter 4: Implementing Schemas in BizTalk Applications 


The CustomerOrderMessage message is added to the CustomerOrder project. Next, let’s add 
the different orchestration shapes to build the business process of the CustomerOrder project 
and to exchange data by using the schema based CustomerOrderMessage message. 


Adding Different Shapes to the Orchestration 


In this section, we will add different orchestration shapes from the Toolbox onto the 
orchestration surface area to build the CustomerOrder business process. We will be adding the 
following shapes in the CustomerOrderOrchestration orchestration: 


Q Port shapes 
Q Send and Receive shape 
Q Decide shape 


Q Terminate shape 
Let’s now learn how to add these shapes in the following sections. 


Adding Port Shapes in the Project 

A Port shape is a logical representation of a message that defines where and how 

CustomerOrderMessage is transmitted in the CustomerOrder project. In our project we need to 

add two Port shapes, the send port (CustomerOrderReceivePort) and the receive port 

(CustomerOrderReceivePort). Port shapes can be added in the CustomerOrderOrchestration 

orchestration by following these steps: 

1. Drag a Port shape from the Toolbox onto the Port surface area. The Port Configuration 
Wizard dialog box appears, as shown in Fig.Biz-4.12. 

2. Click the Next button on the Port Configuration Wizard dialog box (Fig.Biz-4.12) and go to 
the next stage to set the Port Properties of the new port, as shown in Fig.Biz-4.13. 


Port Configuration Wizard 


Welcome to the Port Configuration 
Wizard. 


bAhuverasstt 
Biztalk Server 2006 
This wizard helps you to configure a port, 


In the Orchestration Designer, Send and Receive activities connect to 
Parts so that they can send and receive messages. 


a | v 


a 


Fig.Biz-4.12 
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De 


Enter the port name as CustomerOrderReceivePort below the Name field (Fig.Biz-4.1 3). 
Click the Next button (Fig.Biz-4.13). This takes you to the next stage of the Configuration 
Wizard, that is Select a Port Type, as shown in Fig.Biz-4.14. Here, you have to define and 
set the operations that you want the new port to do. 


Port Properties 


Enter the required properties for the new port, 


Narnve: 
[EusionerordeReceverori iy ‘ 


< Previous (Les 1 +Ep Cancel | : 


Fig. Biz-4.13 
Select the Create a new Port Type radio button below the Select the port type to be used 
for this port option (Fig.Biz-4.14). 


6. Enter CustomerOrderPortType below the Port Type Name field (Fig.Biz-4.14). 


Port-Configuration Wizard — 


Select a Port Type 
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Fig.Biz-4.14 
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7. Select the One-Way radio button below Communication Pattern (Fig.Biz-4.14). 
Select the Internal — limited to this project radio button below Access Restriction: 
(Fig.Biz-4.14). 

9. Now, click the Next button (Fig.Biz-4.14). This takes us to the next step of the Por 
Configuration Wizard, as shown in Fig.Biz-4.15. Here, we Select the appropriate binding fo 
the new port. 


10. Select the Vl always be receiving messages on this port option from the Port direction o 
| communication drop-down list (Fig.Biz-4.15). 
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Fig.Biz-4.15 


11. Select the Specify later option from the Port binding drop-down list (Fig.Biz-4.15). 
12. Click the Next button to go to the final step of Port Configuration Wizard (Fig.Biz-4.15). 


Port Configueation Wizark 
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Fig.Biz-4.16 
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13. Click the Finish button to add CustomerOrderReceivePort port. 


The CustomerOrderReceivePort port shape is thus added to the CustomerOrder project. This 
port shape is used to receive messages from the source location. Now we have to add the send 
port shape to send messages to the destination location. The send port shape can be added in the 
CustomerOrder project by making the following modifications in the steps used to adding the 
CustomerOrderReceivePort port shape discussed earlier: 


1. Enter the port name as CustomerOrderSendPort and press the Next key (see step 3 of the 
‘Adding Port Shapes in the Project’ section earlier in the chapter). 

2. Select the Use an existing Port Type radio button below Select the port type to be used for 
this port, as shown in Fig.Biz-4.17. 


3. Select CustomerOrder.CustomerOrderPortType port type below Available Port Type 
(Fig.Biz-4.1 7). 
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Fig.Biz-4.17 


4. Select VIl always be sending messages on this port option from the Port direction of 
communication drop-down list option (see step 10 and Fig:Biz-4.15 of the ‘Adding Port 
Shapes in the Project’ section earlier in the chapter). To complete the process of adding 
CustomerOrderSendPort to our project, follow the remaining steps (11-13) from the said 
section. 

For more information on how to add ports, please refer to the ‘Adding Ports in the Project’ 

section in Chapter 3. 

Let us now add the Receive and Send shapes in the CustomerOrder project. The Receive shape 

is used to receive messages from a port and the Send shape is used to send a message from a 

port in the business process orchestration. The Receive and Send shapes are added in 

CustomerOrderOrchestration to build the business process of the CustomerOrder project. 
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Adding the Receive/Send shapes 


We need to add the Receive shape and the Send shape in CustomerOrderOrchestration. The 
Receive shape (CustomerOrderReceiveShape, in our case) is used to receive message from the 
CustomerOrderReceivePort port and the Send shape (CustomerOrderSendShape, in our case) is 
used to send messages from the CustomerOrderSendPort port in the business process 
orchestration. The Receive and Send shape can be added to the CustomerOrderOrchestration 
orchestration by following these steps: 


1. Drag the Receive and Send shapes from the Toolbox in the Orchestration designer surface 
area where the point labeled Drop a shape from the toolbox here is indicated. The 
Receive_1 and Send_1 shapes are added to your CustomerOrderOrchestration. 


2. Change the properties of the Receive_1 shape according to the values in Table 4.2. 


Table 4.2: Property Values for Receive _1 shape 


Property Value 

Activate True 

Message CustomerOrderMessage 

Name CustomerOrderReceiveShape 

Operation CustomerOrderReceivePort.CustomerOrderOperation.Request 


3. Change the following properties of the Send_1 shape according to the values in Table 4.3. 


_ Table 4.3: Property Values for Send_1 shape 


Property Value 

Message CustomerOrderMessage 

Name CustomerOrderSendShape 

Operation CustomerOrderSendPort.CustomerOrderOperation.Request 


To know more about how to add the Send and Receive shapes, please refer to the ‘Adding 
receive/send shape’ section of Chapter 3. 


The CustomerOrderReceiveShape and CustomerOrderSendShape shapes are thus added to your 
CustomerOrderOrchestration. Next, we will add the Decide shape in the project. The Decide 
shape is used to add business rules that are discussed in the next section 


Adding the Decide Shape 


The Decide shape is just like conditional branching that enables you to implement business rules 
in a business process orchestration. In conditional branching, the flow of the control passes from 
one operation in a business process to another based on a condition. It is similar to an IF THEN 
ELSE condition in a programming language. To know more about the Decide shape, please refer 
to the ‘Decide shape’ section of Chapter 2. 
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In our project, we will use the Decide shape to check the OrderedProductQuantity and the 
OrderedProductPrice child fields. We already know that when a customer places an order, the 
values of the OrderedProductQuantity and the OrderedProductPrice child fields should not and 
cannot be 0 (zero). In case the value is equal to 0, then the Else part of the Decide shape will be 
executed; otherwise, the main part of the Decide shape (Rule_1) is executed (see Fig.Biz-4.18). 
We write these conditions in the Expression Editor of Decide shape that we will discuss later in 
this section. 


Let us now add the Decide by following these steps: 


1. Drag the Decide shape from the Toolbox onto the Orchestration surface area below 
CustomerOrderReceiveShape. Decide_1 is added in the CustomerOrderOrchestration 
orchestration. 


bo 


Change the name of Decide_1 to CustomerOrderDecideShape from the Properties pane, as 
shown in Fig.Biz-4.18. 


5 CustomerOrder - Microsoft Visual Studio : 

Fie Edt View Project Build Oebug Blak Tools window =! 
3 jy Ww & 22 Oj. * jel ¥ Development * .NET ane 
-CustomerOrder..estration.odx®  CustomerCrderSchemaxsd”  StetPage + 
= 


Orchestration Properties 

CustomerOrderRe “J Orchestration Parameters 
=) . 

CustomerOrde ——— = ~— 


CustomerOrderR 


jyanioo, /)4) 


Request -———— 


Customer OrderDecideShape 


be) 
Rule_1 Else 


—— bs Name CustomerOrderDecideShape 2 


P| Report To Analyst True 
CustomerOrderS | 
Ss S 


reise, wees OCS SESE SERRE 
Spacifies the orchestration object type, 


Item(s) Sav red = 


Fig.Biz-4.18 


After adding the Decide shape to the CustomerOrder project, the next step is to change the 
properties of the Rule_1 decision box and implement the business rules in the 
CustomerOrderDecideShape. Business rules are logical expressions used to manipulate the 
values (perform mathematical, logical computations) contained within the child fields 
(OrderedProductQuantity and OrderedProductPrice in our case) of the CustomerOrderSchema 
schema. These rules are used to validate the data of a schema within a specified range or format. 
We can implement a business rule in CustomerOrderDecideShape by following these steps: 


1. Change the name of Rule_1 to CustomerOrder: OrderedProductQuantity not equal to zero 
from the Properties pane of Rule_1, as shown in Fig.Biz-4.19. 
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Fig.Biz-4.19 
To show the Properties pane of Rule_1, select Rule_1 from the Orchestration designer surface 
area. 
2. Double-click CustomerOrder: OrderedProductQuantity and OrderedProducePrice not 
equal to zero from the Orchestration designer area to open the BizTalk Expression Editor 
dialog box, as shown in Fig.Biz-4.120. 
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BizTalk Expression Editor enables you to create expressions to expand the capabilities of 
various orchestration designer shapes. It enables you to assign values to messages or 
message parts in the Message Assignment shape and manipulate the values of variables in 
the Decision shape. 
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3. Now, enter the following Boolean logic in BizTalk Expression Editor dialog box: 


CustomerOrderMessage(CustomerOrder.PropertySchema.OrderedProductQuantity) 
|| CustomerOrderMessage(CustomerOrder.PropertySchema.OrderedProductPrice) 


4. Next, click the OK button to close the BizTalk Expression Editor dialog box. 


Now, drag CustomerOrderSendShape and drop it below’ the CustomerOrder: 
OrderPropertyQuantity greater than zero rule of CustomerOrderDecideShape. You can see 
CustomerOrderSendShape in the encircle area as shown in Fig.Biz-4.21. This is require, to test 
the CustomerOrder project, when the value of OrderedProductQuantity and 
OrderedProductPrice child fields is not equal to zero and all the shape specified below the 
CustomerOrderDecideShape will be executed. 


After adding the Decide shape, it is time to add the Terminate shape. The Terminate shape is 
used to terminate business activities when an error occurs during business process orchestration. 
Let’s learn how to add the Terminate shape in our project. 


Adding the Terminate Shape 
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The Terminate shape is used when an error takes place in a business process. You can use it to 
immediately end all activities of running an orchestration instance. When an orchestration 
instance is terminated, an error message is generated that is used to print the error in your 
application. You can add an error message string to help the administrator to diagnose the 
situation. The Terminate shape can be added by the following steps: 


1. Drag the Terminate shape from the Toolbox onto the Orchestration designer surface area 
below the Else decision box. The Terminate_1 shape is added to your 
CustomerOrderOrchestration. 


2. Change the name of Terminate_1 to CustomerOrderTerminateShape from the Properties 
pane, as shown in Fig.Biz-4.21. 
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The error message can be added to the CustomerOrderTerminateShape by the following steps: 


1. Double-click CustomerOrderTerminateShape from the Orchestration designer area to open 
the BizTalk Expression Editor dialog box, as shown in Fig.Biz-4.22. 


BizTalk Expression Editor eS ak ‘xi 


Enter an expression that returns a string. Examples; 
“Process terminated due to aborted transaction’; 
myObject.returnErrorStting(}; 


"Process terminated due to zero entered on OrderedProductQuantity and OrderedProductP: «| 


Fig. Biz-4.22 


2. Enter the following error message in BizTalk Expression Editor dialog box: 


“Process terminated due to zero entered on OrderedProductQuantity and 
OrderedProductPrice"; ( Fig.Biz- 4.22.) 
3. Click the OK button to close the BizTalk Expression Editor dialog box. 


Now the schema based project CustomerOrder is complete and ready to be deployed. 
However, before deploying the project, you will need to first assign a Strong Name to the 
project. The steps for assigning a strong name are given in the “Performing the Assignment of 
Strong Naming to the Assembly” section of Chapter 3. 


After assigning a strong name to the assembly, the next task is to deploy the CustomerOrder 
project. We take this up in the next section. 


Deploying the Project 
After adding the OrderService schema, CustomerOrderMessage, and different shapes in the 
CustomerOrderOrchestration orchestration to the CustomerOrder project, the project is 
complete and ready to be deployed on BizTalk Server 2006. You can deploy CustomerOrder 
project through the Microsoft Visual Studio 2005. 


The CustomerOrder project can be deployed by the following steps: 


1. Select Build>Deploy CustomerOrder from the CustomerOrder-Microsoft Visual Studio 
2005 screen. 
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Once you deploy the CustomerOrder project successfully, you will get the successfully 
deployment with zero (0) error essage at the bottom of the output tab of Visual Studio. When you 
deploy the CustomerOrder project, the .NET framework will automatically build the project 
before deploying it. 


Once the CusotmerOrder project has been successfully deployed on BizTalk Server, it is the 
time to test the project by accessing it in BizTalk Server 2006. This is discussed next. 


Accessing the Application in BizTalk Server 2006 


Accessing the CustomerOrder project involves configuring the project (developed in Microsoft 
Visual Studio 2005) for its working in BizTalk Server 2006. You can configure the project 
through BizTalk Server Administrator Console or BizTalk Explorer. In Chapter 3, we had 
configured the BizTalk project through BizTalk Server Administrator Console but in this chapter, 
we will configure the CustomerOrder project through BizTalk Explorer. 


You must deploy the CustomerOrder project before accessing it. To know how to deploy 
CustomerOrder, refer to the Deploying the Project section of this chapter. 


Using the BizTalk Explorer 


The BizTalk Explorer tool is used for configuring the BizTalk project. Configuring the 
CustomerOrder project in BizTalk Explorer involves the following steps: 


Q Adding and Configuring Receive Port 
Q Adding and Configuring Send Port 
Q Configuring Orchestration 


We will discuss the steps shortly this chapter. These steps have to be performed within BizTalk 
Explorer. Therefore, let’s first open BizTalk Explorer in Microsoft Visual Studio 2005 by 
following these steps: | 


1. Select View>BizTalk Explorer to open the BizTalk Explorer dialog box, as shown ir; 
Fig.Biz-4.23. 


BizTalk Explorer ess | 


het as Bh | 


| & @e Biz Talk. con nee sea 


#] ey emma 

eal ‘@ Orchestrations 

fl Ugg Roles 
‘a Parties 
lg Send Port Groups | 
Lg Send Ports 
ig Receive Ports 


Fig.Biz-4.23 
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2. Expand the BIZTALKSERVERO6\SQLEXPRESS.BizTalkMgmtDb.dbo node from Fig.Biz-4.23 
to add receive ports in the Receive Ports folder, send ports in the Send Ports folder, and 
configure orchestrations in the Orchestration folder. 


Now you need to add physical send/receive ports and connect them to the logical send/receive 
ports (CustomerOrderReceivePort and CustomerOrderSendPort in our case) that are added in 
CustomerOrderOrchestration to exchange XML schema messages. 


Adding and Configuring Receive Port 


BizTalk Explorer is used to connect the logical receive ports with the physical receive ports. You 
need to bind these two ports in order to exchange XML messages among the different computers 
within an organization. We have already configured the logical receive ports in the ‘Adding 
send/receive shapes’ section of this chapter. The Physical Receive Ports can be added and 
configured by following these steps: 


1. Right-click the Receive Ports node and Select the Add Receive Ports option from the context 
menu to open the Create New Receive Port dialog box, as shown in Fig.Biz-4.24. 


2. Select the type of Receive Port as One-Way Port from the drop-down list (Fig.Biz-4.24). 


Create New Receive Port — | _ 


Fig.Biz-4.24 
3. Click the OK button to open the One-Way Receive Port dialog box, as shown in 
Fig.Biz-4.25. 


4. Enter the name of the Receive Port as CustomerOrderReceivePort beside the Name field 
and click the OK button to create the Receive Port (Fig.Biz-4.25). 
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Clicking the OK button adds the new Receive Locations to your BizTalk Explorer. 


5. Right-click Receive Locations and Select the Add Receive Location option from the context 
menu to add the Receive Location. The Receive Location dialog box appears, as shown in 


Fig.Biz-4.26. 


6. Enter the values of the following properties on the One-Way Receive Location Properties 
dialog box as shown in Table 4.4, on the One-Way Receive Location Properties dialog box. 


Table 4.4: Receive location property information — 


Property 
Name 
Transport Type 
Address (URI) 


Receive Pipeline 


When you enter the values against these properties, the resultant Receive Location dialog box 


Value 
CustomerOrderReceiveLocation 
File 

C:\CustomerOrder\receive 


Microsoft.BizTalk. DefaultPipelines.XMLReceive 
(Microsoft.BizTalk.DefaultPipelines.XMLReceive, 
Microsoft.BizTalk.DefaultPipelines, 
Version=3.0.1.0,Culture = neutral, 
PublicKeyToken=31bf3856ad364e35) 


will appear as shown in Fig.Biz-4.26. 
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Fig.Biz-4.26 
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7. Now, click the OK button to close the Receive Location Properties dialog box. 
CustomerOrderReceiveLocation is now added in the Receive Location folder of BizTalk 
Explorer. This is shown encircled in Fig.Biz-4.32. 

8. Right-click CustomerOrderReceiveLocation in BizTalk Explorer and Select the Enable option 
from the context menu. 


The physical receive = port. ~=(CustomerOrderReceivePort) and _ its location 
(CustomerOrderReceiveLocation) are now added and configured through BizTalk Explorer, and 
the next task is to add and configure Send Ports in BizTalk Explorer. 


Adding and Configuring Send Port 


The Send Port is used to send XML schema messages from the source location to the destination. 
The Send Port can be added and configured by following these steps: 


1. Right-click the Send Ports node (Fig.Biz-4.23) and Select the Add Send Port option from 
context menu to open the Create New Send Port dialog box, as shown in Fig.Biz-4.27. 


Create New Send Fort | 


Fig.Biz-4.27 
Select the type of send port as Static One-Way Port from the drop down list (Fig.Biz-4.27). 


Click the OK button to open the Static One-Way Send Port dialog box. as shown in 
Fig.Biz-4.28. 


4. Enter the values of the following properties, as shown in Table 4.5 onto the Static One-Way 
Send Port Properties dialog box (Fig.Biz-4.28). 


Property Value 


Name CustomerOrderSendPort 

Transport Type File 

Address (URI) C:\CustomerOrder\send\%MessagelD%.xml 

Send Pipeline Microsoft.BizTalk.DefaultPipelines.XMLTransmit 
(Microsoft.BizTalk.DefaultPipelines.XMLTransmit, 
Microsoft.BizTalk.DefaultPipelines, Version=3.0.1.0, 


Culture=neutral, PublickKeyToken=31bf3856ad364e35) 


To change the values of the properties of the Send Pipeline in Table 4.5, open the Send folder 
from the left pane of the Static One-Way Send Port Properties dialog box (Fig.Biz-4.28). 
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Fig.Biz-4.28 


Click the OK button on the Static One-Way Send Port Properties dialog box to add the 
CustomerOrderSendPort Send Port in BizTalk Explorer (Fig.Biz-4.28) as well as close the 
dialog box. This takes you to the BizTalk Explorer dialog box (Fig.Biz-4.32). 


Right-click CustomerOrderSendPort in the BizTalk Explorer dialog box and Select the Start 
option from the context menu to start the CustomerOrderSendPort Send Port (Fig.Biz-4.32). 
CustomerOrderSendPort is now activated and ready to send schema messages to the 
destination location. 


Now that the Send Port is added onto BizTalk Explorer, the next task is to configure the 
CustomerOrderOrchestraton orchestration. 


Configuring Orchestration 


The CustomerOrderOrchestration orchestration is used to: bind the CustomerOrderReceivePort 
(Inbound Ports) with the CustomerOrderSendPort (Outbound*Ports) in order to send and receive 
XML schema messages and to assign the BizTalk host name that is used to run the 
CustomerOrder application. These tasks can be performed by the following steps: 


Me 


on 


Expand the Orchestrations node to open CustomerOrder.CustomerOrderOrchestration in 
BizTalk Explorer (Fig.Biz-4.23). 

Double-click CustomerOrder.CustomerOrderOrchestration to open the Port Binding 
Properties dialog box, as shown Fig.Biz-4.29. 

Select CustomerOrderReceivePort below Inbound Ports and CustomerOrderSendPort 
below Outbound Ports - Static respectively from the Port Binding Properties dialog box 
(Fig.Biz-4.29). 
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4. Now, Select the Host node from the Port Binding Properties dialog box and Select 
BizTalkServerApplication from the Host drop-down list, as shown in Fig.Biz-4.30. 
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Fig.Biz- 4.30 
5. Click the OK button (Fig.Biz-4.30). The BizTalk Explorer dialog box appears on your screen. 


Right-click CustomerOrder.CustomerOrderOrchestration (Fig.Biz-4.32) and Select the Start 
option from the context menu to start CustomerOrder.CustomerOrderOrchestration. This 
displays the BizTalk Explorer — Express Start dialog box, as shown in Fig.Biz-4.31. 
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Testing the Project 
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7. Click the OK button to start CustomerOrder.CustomerOrderOrchestration. 


After successfully configuring and starting CustomerOrderReceivePort, 
CustomerOrderReceiveLocation, CustomerOrderSendPort, and 
CustomerOrder.CustomerOrderOrchestration, your BizTalk Explorer will appear as shown in 
Fig.Biz-4.32. 
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Fig.Biz-4.32 
It is now time to test the CustomerOrder project. 


You now need to test the CustomerOrder project and check whether the 
CustomerOrderMessage message transfers from one location to another on the basis of schema 
(OrderService). 


However, before we go ahead and test the CustomerOrder project, you need to create the 
OrderService.xml file. This file is required to act as a message for transferring message 
information from one location to another. The OrderService.xml file can be obtained by 
following these steps: 


1. Right-click CustomerOrderSchema.xsd from Solution Explorer (Fig.Biz-4.4) and Select the 
Generate Instance option from the context menu to generate the OrderService.xml file. 
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A successful creation of OrderService.xml file message is shown in the Output pane of Microsoft 
Visual Studio 2005 as soon as the file is created. 


, 


After creating OrderService.xml file, it is time to test of the CustomerOrder project. This can be 
done by the following steps: 


1. Copy the OrderService.xml XML file to the receive folder location, that is 
C:\CustomerOrder\receive, and wait for BizTalk Server to send that file to the destination 
folder (C:\CustomerOrder\send), as shown in Fig.Biz-4.33. 
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2. After a few second, the OrderService.xml file is transferred to the destination folder, that is 
C:\CustomerOrder\send. To check the OrderService.xml file, type the following URL: 
C:\CustomerOrder\send\{18C4F661-C9F7-4E39-B508-3DA547B6DEEE}.xml in Internet 
Explorer, as shown in Fig.Biz-4.34. 


#2 C\CustomerOrder\send),{18C4F661,C9F7-4E99-B508-3DA + Walbro ts sephor -|5} x} 
ee, wee 
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UE 2. c:\CustomerOrder|send|{18C4F661-C9F7-4€39-B508,. My > Gl > ies ch Rage | ~ (ih Tools. « 


<?xml version="1,0" encoding="utf- 16" ?> 

<ns0:OrderService xmins msd="http:/ / CustomerOrder_CustomerOrderSchema" 
<CustomerName>CustomerName_0O</CustomerName> 
<CustomerAddress1>CustomerAddress1_0</CustomerAddress1> 
<CustomerSddress2>CustomerAddress2_0</CustomerAddress2 > 
<CustomerCity >CustomerCity_0</CustomerCity> 
<CustomerS tate >CustomerState_0O</CustomerState> 
<CustomerZip>CustomerZip_O</CustomerZip> 
<CustomerContactPhone >CustomerContactPhone_O</CustomerContactPhone 
<OrderedProductNumber>OrderedProductNumber_O</OrderedProductNumber> 
<OrderedProductQuantity >10 </OrderedProductQuantity> 
<OrderedProductPrice >10.4 </OrderedProductPnce> 

</ns0;OrderService> 


Fig.Biz-4.34 
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When you transfer the OrderService.xml file to the destination folder (C:\CustomerOrder\send), 
the name of the OrderService.xml file changes in the destination location. In our case, the name 
changes to {18C4F661-C9F7-4E39-B508-3DA547B6DEEE}.xml file. The name {18C4F661-C9F7- 
4E39-B508-3DA547B6DEEE}.xml will change again during the testing the application. 

This delivery of the OrderService.xml file (Fig.Biz-4.34) is an indication that your 
application is configured properly through BizTalk Explorer and can be easily accessed by 
BizTalk Server 2006. This ensures that if value of OrderedProductQuantity and 
OrderedProductPrice is not zero, message transfer process is not terminated. 

The CustomerOrder project we created is based on BizTalk schema. We are now going to 
modify the CustomerOrder project by adding BizTalk flat file schema to the project. We will 
also map the contents of incoming messages in flat file format. Let us thus quickly proceed to 
learn how to develop a BizTalk flat file schema in the CustomerOrder project. 


Working with Flat File Schemas 


A flat file is a computer file that can only be read or written sequentially. It consists of one or 
more records separated by a comma, tab, pipe, or just plain text in a single string. Each record 
contains one or more field instances and each field instance can contain a data value. 


A flat file contains machine-readable data that is typically encoded as printable characters and 
usually contains a series of records (or lines), where each record is a sequence of fields. Flat files 
are needed in BizTalk Server to convert flat file schemas to XML schemas, which can then be 
added to messages to be sent or received from one location to another. Let’s take the example of 
a simple flat file containing employee data. The file contains one or more employee records and 
each record contains the following three fields: 


Q Employee's social security number (ssn) 

Q Employee's name 

Q Employee's salary 

The contents of the employees’ flat file are as follows: 
Q 123456789,"Mahtab", 100000.00 

Q 444556666,"Santosh ", 87000.00 

Q 777227878,"Ambrish ",123000.00 


Each record contains information of a single employee. The format of the flat file is Comma 
Separated Value (CSV), which means that each field is terminated by a comma. 


Now, the flat file of the employees’ record can be converted into XML schema by the following 
XML document: 


<?xml version='1.0'?> 
<emp loyees> 
<emp loyee> 
<ssn>123456789</ssn> 
<name>Mahtab</name> 
<salary>100000.00</salary> 
</employee> 
<emp loyee> 
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<ssn>444556666</ssn> 
<name>Santosh</name> 
<salary>87000.00</salary> 

</emp loyee> 

<emp loyee> 
<ssn>777227878</ssn> 
<name>Ambrish</name> 
<salary>123000.00</salary> 

</emp loyee> 

</emp loyees> 


Let us now learn how to add a flat file schema to our CustomerOrder project. 


Adding a Flat-File Schema to the Project 


Flat file schemas are used to define the structure of the same record and field characteristics as 
defined in XML schemas format. It also lets you translate a flat file instance message into an 
equivalent XML instance message (or vice versa). A flat file schema can be added in the 
CustomerOrder project by following these steps: 


1. Open the CustomerOrder project. 


2. Right-click CustomerOrder from the Solution Explorer pane and Select Add> New Item from 
the context menu to open the Add New Item - CustomerOrder dialog box, as shown in 


Fig.Biz-4.35. 

3. Select Schema Files from the Categories pane and Flat File Schema from the Templates pane 
(Fig.Biz-4.35). 

4. Enter the name of flat file schema as CustomerOrderFlatFile.xsd beside the Name field 
(Fig.Biz-4.35) 
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Fig. Biz-4.35 


5. Now, click the Add button to add the flat file schema in the CustomerOrder project. A 
screen as shown in Fig.Biz-4.36 appears. 
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Fig.Biz-4.36 


6. Right-click the Root node and Select the Rename option from context menu and change the 
name of the Root node to CustomerOrderService. 


7. Change the Child Delimiter Type property to Character (Fig.Biz-4.36). 


The BizTalk CustomerOrderFlatFile flat file schema is thus added to the CustomerOrder project 

and the name of Root node is changed to CustomerOrderService. The next step is to insert child 

field elements in the CustomerOrderService root node. The child field elements can be added 

by the following steps: 

1. Right-click the CustomerOrderService node and Select Insert Schema Node>Child Field 
Element from the context menu. Enter the name of the child field as CustomerName, shown 
encircled in Fig.Biz-4.37. 


2. Enter 40 beside the Minimum Length with Pad Character property in the Properties pane. 
Note 


a SS eeeeeeeeeeEeeeEeEeEeEeeeeeeEeeeeEeeEeee—e———ee—e—eeEeEeEeEeEeEeEeEeEEEEEeE—————————ee 


| Ensure that all the records that eu are creating are of same format. That’s why the nodes you are cena: are child field 
element of the root node, 


Serenata ran LEM ANA ai a 


3. Now the CustomerName child field is added to the CustomerOrderService root node. 
Repeat step 1 and step 2 to add the following child fields along with their corresponding 
Minimum Length with Pad Character properties, as shown in Table 4.6, to the 
CustomerOrderService root node. The Minimum Length with Pad Character property is 
used to set the length of a field so that it is lesser than or equal to a certain length in your 
output document. 
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"Table 4.6: Flat File child field name and minimum length 


CustomerAddress1 40 
CustomerAddress2 40 
CustomerCity 30 
CustomerState 30 
CustomerZip 10 
CustomerContactPhone 12 
OrderedProductNumber 8 

OrderedProductQuantity 5 

OrderedProductPrice 10 


After adding all the child fields onto the CustomerOrderService root node, you will see a screen 
as shown in Fig.Biz-4.37. 
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Fig.Biz-4.37 


Now save the project. The CustomerOrderFlatFile flat file schema has been created successfully. 
Next, it is time to map the CustomerOrderMessage message with the CustomerOrderFlatFile flat 
file schema. 
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Mapping the Messages 


4. 


BizTalk Mapper enables you to transform data records of one format (XML schema) to another 
(flat file schema) and also map the fields in the input record to the fields in the output record. 
You can use the mapper to map XML messages (instances of XML schema at runtime) to an 
alternate format (flat file format) to exchange messages. Messages can be mapped by the 


following steps: 


1. Right-click CustomerOrder from the Solution Explorer pane and Select Add> New Item from 
the context menu to open the Add New Item — CustomerOrder dialog box, as shown in 


Fig. Biz-4.38. 


Select Map Files from the Categories pane and Map from the Templates pane (Fig.Biz-4.38). 


Enter the name of map file as CustomerOrderMap.btm beside the Name field (Fig.Biz-4.38). 
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Fig.Biz-4.38 


Fig.Biz-4.39 appears. 
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Fig.Biz-4.39 
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Now, click the Add button to add the map file. A screen similar to the one shown 
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Click the Open Source Schema hyperlink (Fig.Biz-4.39). This will display the BizTalk Type 
Picker dialog box, as shown in Fig.Biz-4.40. 


oe 


Cancel 4 
“FigBiz-440 
Expand the CustomerOrder node in the BizTalk Type Picker dialog box (Fig.Biz-4.40). 


Next, expand the Schemas node and Se/ect CustomerOrder.CustomerOrderSchema, as 
shown in Fig.Biz-4.41. 
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tO 
2: 


10. 
Tt: 


12. 
13: 


14. 


15: 


Now, click the OK button to add the OrderService schema in Source Schema. 

Similarly, click the Open Destination Schema hyperlink (Fig.Biz-4.39). The BizTalk Type 
Picker dialog appears (Fig.Biz-4.40). 

Expand the CustomerOrder node (Fig.Biz-4.40). 


Now, expand the Schemas node and_ Select CustomerOrder.CustomerOrderFlatFile 
(Fig.Biz-4.41), | 


Click the OK button to add the CustomerOrderService schema in Destination Schema. 


Next, expand the OrderService and the CustomerOrderService nodes. You will see a screen 
as shown in Fig.Biz-4.42 


Connect the child field names in Source Schema to their corresponding child field names inj 
Destination Schema by dragging each child field in Source Schema and dropping it ini 
Destination Schema (for example, drag the CustomerName child field in Source Schema 
and drop it in the CustomerName child field in Destination Schema. 


Similarly, connect all the child fields of Source Schema with their corresponding child fields 
in Destination Schema, as shown in Fig.Biz-4.42. 


 CustomerOrder,- Microsoft Visual Studio 


=O! x! 


File Edit View Project Build Debug BizTalk Tools Window Cormmunity Help 


ee el of bed aa 8 ss - al = Development + .NET ~ i fA 

pees se satapeomr esa, moderne eT 
CustomerOrderMap.btm stomer' Wad pete a ca ee Oe | Solution Eploray = Selgiion Custollie oy 

H = Wy <Schema> ‘Se ||) 2) Solution ‘CustomerOrder’ (1 project) 

j =) =) OrderService CustomerOrderService |) =! Bt] CustomerOrder 

| $2 CustomerNam CustomerName gi || Fa) References 

{ ‘gp CustomerAdd CustomerAddresst GS } eq) CustomerOrderFlstFile, xsd 

nee at mC 
; =p CustomerAddr —— CustomerAdddress2 ge |)! &) CustomerOrderMap. btm 


i 
1! = . = 

aS = | &) CustomerOrderOrchestration, odx 

‘sp CustomerCity i oF 

! 


Customerlity dg || 
2! oa gy CustomerOrderSchema, xsd 


sh CustomerStat CustomerState @= | & PropertySchema.xsd 
<3 Customerzip CustomeiZip &2) | 73 

=) ord CustomerContactPhone & | 

$23 OrderedProdu OrderedProductNumber @2 | 

= OrderedProdu OrderedProductQuantity ¢ 


5 [OrderedProdu 


‘OrderedProductPrice fees 


Page 1 


| Show output from: 


General 


J] 
ma] a i © 3)Salution Explorer | roperties 


Fig.Biz-4.42 


After we have mapped the child fields in Source Schema to those in Destination Schema, thi 
next step is to validate the mapping to ensure that it has been done in the correct format. 
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Validating the Mapping 


You need to validate the mapping for internal inconsistencies, or other errors that may prevent it 

from being used effectively for mapping schemas. You can validate the mapping by the 

following step: 

1. Right-click CustomerOrderMap from the Solution Explorer pane and Select the Validate 
Map option from the context menu to validate the map. The following message will appear 
in the Output window: 


Invoking component... 
C:\Documents and Settings\Administrator\My Documents\Visual Studio 
2005\Projects\CustomeroOrder\CustomerOrder\CustomerOrderMap.btm: The output XSLT 
is stored in the following file: <file:///C:\Documents and 
Settings\Administrator\Local Settings\Temp\_MapData\CustomerOrderMap.xs1> 
C:\Documents and Settings\Administrator\My Documents\Visual Studio 
2005\Projects\CustomerOrder\Customerorder\CustomerOrderMap.btm: Tne Extension 
Object XML is stored in the following file: <file:///C:\Documents and 
Settings\Administrator\LocalSettings\Temp\_MapData\CustomerOrderMap_extxm] .xm1> 
Component invocation succeeded. 

This message shows that the mapping of CustomerOrderMap has been successfully validated. 


The next task is to test the map, which we cover in the following section. 


Testing the Mapping 
A mapping is tested to verity whether the map you designed produces the correct output. The 


testing is used to generate a test instance from the fields in the Source instance document to the 
Destination instance document. The mapping can be tested by the following step: 


1. Right-click the CustomerOrderMap from Solution Explorer and Select the Test Map option 
from the context menu to test the map. The following message will appear in the Output 
pane: 


Invoking component. 

Test Map used the Following file: <file:///C:\Documents and 
Settings\Administrator\Local Settings\Temp\inputfile.xml> as input to ithe map. 
Test Map success for map file C:\Documents and Settings\Administrator\My 
Documents\Vi sualStudio2005\Projects\CustomerOrder\CustomerOrder\CustomerOrderMa 
p.btm. 

The output is stored in the following file: <file:///C:\Documents and 
Settings\Administrator\LocalSettings\Temp\_MapData\CustomerOrderMap_output.xm1> 
Component invocation succeeded. 


Next, let’s add a flat file schema based message that will be used to exchange information 
among different locations. 


Adding a Schema to Messages 


In this project, we use the CustomerOrderFlatFileMessage flat file schema as a message, which 
will be used to exchange information within an organization (which, in our case is a restaurant 
or hotel). You can add the CustomerOrderFlatFileMessage schema onto the Message folder by 
following these steps: 
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1. Right-click the Messages folder in the Orchestration View pane and Se/ect the New Message 
option from the context menu to add a message. The Message_1 message is added to the 
Message folder. 

2. Change the properties of the Message_1 message according to values mentioned in 
Table 4.7. 


Table 4.7: Properties and values of Message_1 message 


Property Value 
Identifier CustomerOrderFlatFileMessage 
Message Type CustomerOrder.CustomerOrderFlatFile (Schemas node) 


After applying these property values, CustomerOrderFlatFileMessage is added to the Messages 
folder. Let us now add a Port Type that will be used to transfer CustomerOrderFlatFileMessage. 


Adding a New Port Type to the Orchestration 


A Port Type consists of a set of operations such as requests or responses, and the message types 

that these operations can work on. It also defines the type of messages (XML schema, flat file 

schema) to be used in the project. A new Port Type can be added by following these steps in 

CustomerOrderOrchestration: 

1. Right-click the Port Types folder from the Orchestration View pane and Select the New 
One-Way Port Type option from the context menu. PortType_1 is added to the Port Type 
folder. 

2. Change the name of PortType_1 to CustomerOrderFlatFilePortType from the Properties 

pane. 

Expand CustomerOrderFlatFilePortType and change the name of Operation_1 to 

CustomerOrderFlatFileOperation from the Properties pane. 


iS) 


4. Expand CustomerOrderFlatFileOperation and change the Message Type property to 
CustomerOrder.CustomerOrderFlatFile from the Schema node in the Properties pane. 


The CustomerOrderFlatFilePortType Port Type is now added to CustomerOrderOrchestration. 
Next, let’s add different shapes in CustomerOrderOrchestration to build the business process of 
the CustomerOrder project. 


hs 


Adding Different Shapes to the Project 


In this section, we add following types of shapes to build the business process of the 
CustomerOrder project: 


Q Transform Shape 

Q Port 

Q Send Shape 

Let us start by adding a Transform shape to the project. 


108 


Chapter 4: Implementing Schemas in BizTalk Applications 


Adding a Transform Shape 


As discussed in the ‘Orchestration Designer Shapes’ section of Chapter 2, the Transform shape is 
used to transform a message from one format to another. Before adding the Transform shape, 
you need to first delete CustomerOrderTerminateShape below the Else decision box of 
CustomerOrderDecideShape in CustomerOrderOrchestration and add the Transform shape in 
its place. In the earlier project of this chapter, we used the Terminate shape below the Else 
decision box because we wanted to stop our orchestration and display some error message 
defined in the BizTalk Expression Editor of the Terminate shape. However, in this modified 
project we are using the Transform shape in place of the Terminate shape because we don’t 
want to stop our orchestration and instead want to use flat file schema in our modified project. 
When you add a Transform shape, BizTalk Server automatically adds the Construct Message 
shape on the upper part of Transform shape. 


The Transform shape can be added by the following steps: 


1. Drag the Transform shape from Toolbox and drop it below the Else decision box of 
CustomerOrderDecideShape. This area is shown encircled in Fig.Biz-4.43. 


2. Rename the Transform shape as CustomerOrderTransformShape from the Properties pane 
(Fig.Biz-4.43). 


3. Select ConstructMessage_1 and change its name to CustomerOrderConstructMessage from 
the Properties pane. 
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4. Double-click CustomerOrderTransformShape. The Transform Configuration dialog box 
appears, as shown in Fig.Biz-4.44. 
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Fig.Biz-4.44 


5. Select the Existing Map radio button in the Transform Configuration dialog box 
(Fig.Biz-.45). 


6. Select the CustomerOrder.CustomerOrderMap option from the Fully Qualified Map Name 
drop-down list (Fig.Biz-4.45). 


7. Select the Source node from the Transform pane (Fig.Biz-4.45). 


Select the CustomerOrderMessage option from the Variable Name drop-down list at the 
right side of the Source Transform pane, as shown in Fig.Biz-4.45 
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Fig.Biz-4.45 


9. Select the Destination node from the Transform pane and _ Select _ the 
CustomerOrderFlatFileMessage option from the Variable Name drop-down list at the right 
side of the Destination Transform pane, as shown in Fig.Biz-4.46. 


110 


Chapter 4: Implementing Schemas in BizTalk Applications 


Transform Configuration: ©’ d x 
; Enter the configuration information; 
| 
aol New tap 


~~ Destination Transform: 


| Marable Name [ tess, > Part Type sl 
| CustomerOrderFlatFileMessage <O rsr meLOrd 
aia : 


erOrderMap ot —— =| 


1 Oa | 
| Destination Transform: 

i Create destination transform by selecting message parts, Destination transform 
| will be used to create destination schema for mapper. If you modify an existing 
schema then some links might be lost. 


{~ When click OK, launch the Biztalk Mapper, 


Fig.Biz-4.46 


10 Click the OK button to add the Transform shape in the CustomerOrderOrchestration 
orchestration. 


Adding a Port 


A Port can be added to the project by the following steps: 


1. Right-click the Ports folder from the Orchestration View pane and Select the New Port 
option from the context menu. Port_1 is added in CustomerOrderOrchestration. 


2. Next, enter the values of the following properties as shown in table 4.8. 


Table 4.8 Properties for Port_1 Port 


Property Value 

Identifier CustomerOrderFaltFilePort 

Communication Direction Send 

Port Type ate ee (Port Types 
node). 


CustomerOrderFlatFilePort is now added in CustomerOrderOrchestration. Let’s add a Send 
shape next. 


Adding Send Shape * 


A Send shape can be added by following these steps in the CustomerOrderOrchestration 
orchestration. 


1. Drag a Send shape from the Toolbox and drop it below the Transform shape in the 
orchestration surface area. The Send_1 shape is added to CustomerOrderOrchestraton. 


2. Enter the values of the following properties of Send_1 in the Properties pane as shown in 
Table 4.9. 
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Table 4.9 Properties for Send_1 Send Shape 


Property Value 

Name CustomerOrderFlatFileSendShape 

Message CustomerOrderFlatFileMessage 

Operation CustomerOrderFaltFilePort.CustomerOrderFlatFileOperation.Request 


3. Save the project and the modified CustomerOrderOrchestration will appear as shown i 
Fig.Biz-4.47. 
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Fig.Biz-4.47 . 


After adding different shapes in CustomerOrderOrchestration, the next step is to add a Sen 


Pipeline through which flat file schema messages can be sent from the source location to th 
destination location. 


Adding a Send Pipeline 


Send Pipeline is executed in send port and result will be shown in send location. It is responsibl 


for processing flat file schema messages before sending them to their final destinations. The Sen 
pipeline can be added by the following steps: 
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1. Right-click the CustomerOrder project from the Solution Explorer pane. 


2. Select Add>New Item from the context menu to add the Send Pipeline. This displays the 
Add New Item — CustomerOrder dialog box, as shown in Fig.Biz-4.48. 
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Fig.Biz-4.48 


3. Select Pipeline Files from the Categories pane and Send Pipeline from the Templates pane 
(Fig.Biz-4.48). 

4. Enter the name of the Send Pipeline as CustomerOrderSendPipeline.btp beside the Name 
field (Fig.Biz- 4.48). 


5. Click the Add button to add the Send Pipeline. This displays a screen as shown in 
Fig.Biz-4.49, 
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Fig.Biz-4.49 
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The function of the CustomerOrderSendPipeline Pipeline (Fig.Biz-4.49) can be divided into the 
following three stages: 


Q Pre-Assemble: This stage is used to prepare messages for the outbound process. The 
customized code for processing the messages is also added in this stage. 


Q Assemble: When BizTalk has finished processing your messages, they are assembled in XML 
format. In this stage, the data is packed into flat files for shipment to other business entities. 


Q Encode: In this stage, the assembled messages within the Send Pipeline are encoded. In the 
same way, you can decode the assembled message in the Receive Pipeline. 


6. Drag a Fiat file assembler shape from the Toolbox and drop it below the Assemble box 
(Fig.Biz-4.49). 

Set the Document schema property to CustomerOrder.CustomerOrderFlatFile in the 
Properties pane, as shown in Fig.Biz-4.50. 
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Now the CustomerOrderSendPipeline Send Pipeline is added to your CustomerOrder project, 
and with this, the development of the CustomerOrder flat file schema project is also complete. 
Now you need to just save the project and it is ready to be deployed. 


Deploying the Project 
The modified CustomerOrder project can be deployed by the following step: 


1. Select the Deploy CustomerOrder option from the Build menu on the Microsoft Visual 
Studio 2005 window. 


114 


Chapter 4: Impiementing Schemas in BizTalk Applications 


As soon as you deploy your project successfully, you will get the successfully deployment with 
zero (QO) error message at the bottom of the Output tab of Visual Studio. 


After the CustomerOrder project is successfully deployed, it is time to access the project. This is 
described in the next section. 


Configuring the Application in BizTalk Server 2006 


The modified CustomerOrder project can be configured through BizTalk Explorer. This can be 
done by the following steps: 


1. 


Select the BizTalk Explorer menu option from the View menu in Microsoft Visual Studio 
2005 to open BizTalk Explorer (Fig.Biz-4.23). 


Expand the BIZTALKSERVER06\SQLEXPRESS.BizTalkMgmtDb.dbo node (Fig.Biz-4.23). 


Right-click the BIZTALKSERVERO6\SQLEXPRESS.BizTalkMgmtDb.dbo node and Select the 
Refresh option from the context menu. 


We have already added the Receive Port, Send Port and Orchestration while configuring the 
CustomerOrder project earlier in the chapter. Therefore, here we will add only the Send Port for 
sending flat file schema messages. 


Adding Send Ports 
The Send Port can be added by the following steps: 


ie 


Right-click the Send Ports node (Fig.Biz-4.23) and Select the Add Send Port option from 
context menu to open the Create New Send Port dialog box (Fig.Biz-4.27). 


Select the Static One-Way Port option from the Create New Send Port dialog box (Fig.Biz- 
4.27) and click the OK button to open the Static One-Way Send Port Properties dialog box, 
as shown in Fig.Biz-4.28 


Enter the values for the following properties as shown in Table 4.9 in the Static One-Way 
Send Port Properties dialog box (Fig.Biz-4.28). 


Table 4.9: Send Port property information 


Property Value 

Name CustomerOrderFlatFileSendPort 

Transport Type File 

Address (URI) C:\CustomerOrder\sendFlat\%MessagelD%.ixt 
Send pipeline CustomerOrder.CustomerOrderSendPipeline 


(CustomerOrder.CustomerOrderSendPipeline, 
CustomerOrder, Version=1.0.0.0, Culture=neutral, 
PublicKkeyToken =fb14a1¢1d081e8e4) 


To change the values of property of the Send Pipeline, select the Send folder from left pane of 
the Static One-Way Send Port Properties dialog box (Fig.Biz-4.28). 
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4. 


Click the OK button to add the CustomerOrderFlatFileSendPort Send Port in the Static One- 
Way Send Port Properties dialog box. 


Now, Right-click CustomerOrderFlatFileSendPort and Select the Start option from the 
context menu to start the CustomerOrdeFlatFilerSendPort Send Port. 


Now that the Send Port is added to BizTalk Explorer, the next task is to configure 
CustomerOrderOrchestration through BizTalk Explorer. 


Configuring CustomerOrderOrchestration and Selecting Port 


6. 


We 


now need to configure CustomerOrderOrchestration and _ Select the 


CustomerOrderFlatFilePort, which can be done by the following steps: 


Ih 


Expand the Orchestrations node to open CustomerOrder.CustomerOrderOrchestration 
irom BizTalk Expiorer, as shown in Fig.Biz-4.21. 


Double-click CustomerOrder.CustomerOrderOrchestration to open the Port Binding 
Properties dialog box, as shown Fig.Biz-4.51. 


Select the CustomerOrderFlatFileSendPort option from the CustomerOrderFlatFilePort 
drop-down list on the Outbound Port-Static pane (Fig.Biz-4.51). 


Select the Host node. Then Select the BizTalkServerApplication option from the Host drop- 
down list. 


Now, click the OK button to finish the configuration. The BizTalk Explorer dialog box 
appears. 


x 
i =) Configurations ‘El Inbound Ports 
4 Binding CustomerOrderReceivePort = CustomerOrderReceiveFort 
Hast fel Qutbound Ports - Static j 
| CustomerorderSendPart CustomerOrderSendPort 
> etree edema eee ay Customer OrderFlatFileSendPort ina | 


Sei Wa SSeS 


| CustomerOrderFlatFilePort *y, 
| Refers to 6 static port through which the Orchestration sends documents 

to an external entity, Specify 4 Static Send Port or a Send Fort Group. 
SUGARS CARE 


Cancel | Apply Za Bee Help Sie | 


Fig.Biz-4.51 


Right-click the CustomerOrder.CustomerOrderOrchestration and Select the Start option 
from the context menu to. start the CustomerOrder.CustomerOrderOrchestration 
orchestration (Fig.Biz-4.52). 
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After performing all these steps, the BizTalk Explorer will appear as shown in 
Fig.Biz-4.52. 


oo ge 


(ea e) BizTalk. Configuration Databases 
fy BIZTALI \5Q 


| 
eee eng ceepemeeeeannecee 
Fig.Biz-4.52 
Enable Receive Location (CustomerOrderReceiveLocation) from the Receive Ports 
(CustomerOrderReceivePort) node and CustomerOrderOrchestration, if it is disabled. Now the 
CustomerOrder project is ready to be tested. 


Testing the Application 4 


The CustomerOrderFlatFile_output.xml file is needed to test the CustomerOrder project. The 
CustomerOrderFlatFile_output.xml file can be obtained by the following step: 


1. Right-click CustomerOrderFlatFile.xsd from Solution Explorer and Select the Generate 
Instance option from the context menu to generate the CustomerOrderFlatFile_output.xml 
flat file. 


As soon as the CustomerOrderFlatFile_output.xml file is generated, the following message will 
appear in the Output tab: 


Invoking component... 

Create XML Instance succeeded for schema Customer OrderFlatFile.xsd. Generated 
<file:///C:\Documents and Settings\Administrator\Local 
Settings\Temp\_SchemaData\CustomerOrderFlatFile_output.xml> as output. 
Component invocation succeeded. 


After creating the CustomerOrderFlatFile_output.xml file, open it with notepad editor and enter 
zero to OrderedProductQuantity (<OrderedProductQuantity>0</OrderedProductQuantity), and 
also enter zero to OrderedProductPrice (<OrderedProductPrice>0</OrderedProductPrice>) 
child fields. This is require to test the CustomerOrderFlatFile schema of CustomerOrder project. 
The project can be tested by the following steps: 


1. Copy the CustomerOrderFlatFile_output.xml XML file (in our case, the location 
of the CustomerOrderFlatFile_output.xml file is C:\Documents and 
Settings \ Administrator \ LocalSettings\ Temp\_SchemaData\CustomerOrderFlatFile_output. 
xml) to the receive folder location (C:\CustomerOrder\receive), as shown in Fig.Biz-4.53. 
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Wait for some time for BizTalk Server to send the XML based flat file to the destination folder 
(C:\CustomerOrder\send). 


BY C:\Custamerorder\receive! = = : ghana IEE. idl! 
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Back = Search Folders [+ ; ; ; : } 
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LS desktop 
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‘ 
oe , | 


AConfig 


CustomerOrder 
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=y send 


ts and Settings 


_) Tempel 
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<) WINDOWS 


Iai poets oe ope eeneat Boot 
Fig.Biz-4.53 


Once the CustomerOrderFlatFile_output.xml file is transferred in the destination folder 
(C:\CustomerOrder\sendFlat), you can check the file {ODD9F629-C445-443F-B7CE- 
E6D1C6O5EB58E}.txt in the destination folder C:\CustomerOrder\sendFlat as shown in Fig.Biz- 
4.54. The file name {ODD9F629-C445-443F-B7CE-E6D1C65EB58E}.txt will change again 
during the execution of the application. File is converted to TXT format as value of 
OrderedProductQuantity and OrderedProductPrice is zero, it happens because of the expression 
detined tor Decide shape defined earlier. 
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You have deployed and run the flat file schema based project successfully and now are 
equipped with the knowledge to create schema and fiat file based projects of your own. This, 
concludes the chapter. However, before we move to the next chapter, let’s recap the main points 
of this chapter by going through a short summary. 


Summary 


In this chapter, have learned how to create a schema based BizTalk project in the Microsoft 
Visual Studio 2005 environment and shown you in simple steps how configure the project 
through BizTalk Explorer. It takes you through the whole process of adding and configuring the 
various Components needed in the project, after which the project was deployed and tested to 
check for errors and inconsistencies. After testing the schema based BizTalk project, you learned 
about the flat file schema by modifying the schema based project. You also learned how to map 
XML schema base messages to flat file based messages and also configured the modified project 
through BizTalk Explorer. Finally, you learned how to test the modified flat file schema based 
project. 

In the next chapter, we will discuss business rules and develop a policy by using Business Rule 
Composer and also call this policy by developing a BZ project. 
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fe BZ 2006, business rules or business policies are used to define and control the structure, | 
operations, constraints, and strategies of an organization. They are dynamic and subject to_ 
change over time, and can be found in all types of business applications. Finance and insurance, 
e-business, transportation, telecommunications are few of the example that are governed by 
business rules. 


This chapter introduces BizTalk business rules and policies in detail. We will also learn about 
the Business Rule Composer and how we can install it. We will also create, publish, and test a 
policy by using the Business Rule Composer. In the end, we will discuss how to call this policy 
in our BizTalk project. 


Business Rules 


Business rules are agreements, statements and contracts that govern the conduct of business 
processes. A business rule defines as a rule that contains one aspect of your business that is 
intended to assert business structure or influence the behavior of your business. Business rules 
may focus on business calculations. For example, the record of a purchase order may not be 
entered if the customer's credit is less than 50. Some business rules focus on the policies of an 
organization. An example of business policy in a car rental company is “only legal and good 
condition car will be rented to customer”. A business rule consists of three parts: 


Q Rule: Rules are declarative statements that govern business processes. Rule determines the 
business logic, in the form of a comparison of two monetary values, to data or facts, in the 
form of a transaction amount and available funds. You can use the Business Rule Composer 
to create, modify, version, and deploy the business rules. Rules are defined by following 
format: IF condition THEN action, which consists following parts: 


e Condition: A condition is Boolean expression that consists of one or more predicates 
and facts. Predicates are “is less than”, “equal to”, “is greater than” and so on. A 
predicates can also combined with logical connectives such as AND, OR and NOT. 


e Actions: Actions are the functional consequences of condition evaluation. If a rule 
condition is met, the corresponding action or actions of the condition are preformed. 


e Facts: Facts are the data on which business rules operate. For example, "amount" and 
"available funds" are facts. 


To make the picture clearer about condition, action and facts, let us see an example here. 
Consider the following statement: 


IF amount is less than or equal to available funds THEN conduct transaction and print receipt. 
In this example, condition consists two parts: 

“is less than or equal to” 

“amount” and “available fund” 


Actions consist of events that are executed, such as “conduct transaction” and “print receipt”, 
when the condition evaluates to true. Facts as discussed earlier are data such as “amount” and 
“available funds”. 


Q Policy: A policy consists of rules in a group. You need to compose a policy version and test 
the policy using the facts defined in the rules. Policies can be composed using the Business 
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Rule Composer. While using the Business Rule Composer, you need to mention the rules 
that are related to these polices. 

Q Vocabulary: A vocabulary is a collection of definitions, which includes common names of 
the facts used in conditions and actions defined for the rules. Vocabulary helps in 
understanding the rules clearly as vocabulary definitions make the rules easier to read. You 
can build vocabulary through Business Rule Composer. 

You need to ensure that the policy for a rule is defined before using its vocabulary. This helps in 

allotting a version number to the vocabulary. In addition, vocabulary needs to be published 

through the Business Rule Composer. A published vocabulary is provided for preserving its 
referential integrity and for restricting modifications in the vocabulary. 

Let’s now learn how to create a policy and rule in BZ 2006 by using the Business Rule 

Composer. 


Installing the Business Rule Composer 


Business Rule Composer (BRC) is a development tool, which is provided by BZ 2006 for 

authoring, versioning, creating and deploying the policies and vocabularies of your business 

domain. Before you can use the BRC, you need to first install it in your computer. This can be 

done by using the following steps: 

1. Insert the BZ 2006 CD/DVD in the CD-ROM. The CD will start auto-run menu screen as 
shown in Fig.Biz-5.1. 


Read the release notes. 


BizTalk Server 2006 


Fig.Biz-5.1 


2. Click the Install Microsoft BizTalk Server 2006 on this computer link (Fig.Biz-5.1) to open 
the Program Maintenance screen, as shown in Fig.Biz-5.2. 
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@ Microsoft BizTalk Se 


Program Maintenance 
Modify, repair, or remove the prograrn 


aa es which features are installed. This option displays the Component Selection dialog box 
that you can use to change which features are installed. 


f° Repair 


ne Repar installation errors in the pragram. This option tives missing or comupt tiles, shortouts, and 
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Cancel 4 


Fig.Biz-5.2 


3. Select the Modify radio button (Fig.Biz-5.2) and click the Next button to open the 
Component Installation screen, as shown in Fig.Biz-5.3. 
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4. Expand the Additional Software node (Fig.Biz-5.3) and select the Business Rules 
Components subnode on the Component installation screen, as shown in Fig.Biz-5.4. 
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Microsoft BizTalk Server 2006, Instal 
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Fig.Biz-5.4 
5. Click the Next button (Fig.Biz-5.4) to open the Summary screen, as shown in Fig.Biz-5.5. 


Summary 
Review components to be installed. 


To start the installation, click Install. To make changes, click Back, 


Microsoft BizTalk Server 2006 Components Al 


The following components will be installed; 


- Business Rules Components 


It may be necessary to stop one or more system services during installation. For 
inforrnation on the affected services, click Help. 

You can add or rem additional components after this installation using the 
"Microsoft BizTalk Server 2006" entry in the 4dd/Remove section of the Control 
Panel, 


bse cook _| 


In the Summary screen, you can view the components that we are going to install. 


6. Click the Install button on the Summary screen to start the installation process, as shown in 
Fig.Biz-5.6. 
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& Microsoft BizTalk Server 2006 Installatia 


Installation Progress Ee 
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Fig.Biz-5.6 
After the installation process gets completed, the Installation Completed screen opens, as shown 
in’ Fig. Biz-5,7; 
7. Click Finish to close the screen and open the BizTalk Server Configuration screen. Now, 
you can configure the BizTalk Server as mentioned in Chapter 1 of the book. 
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Fig.Biz-5.7 


Now that the BizTalk Rule Composer (BRC) is installed in your computer, let’s access it by the 
following steps: 


1. Click Start>All Programs Microsoft BizTalk Server 2006 Business Rule Composer to 
open the BRC screen, as shown in Fig.Biz-5.8. 
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Fig.Biz-5.8 


Sometimes, there is a need to load the policies from the BizTalkRuleEngineDb database, if it is 
not loaded by default. Otherwise, you can load the polices by using the Rule Store>Load menu 
options in Fig.Biz-5.8. 


Let’s now learn how to create a policy. 


Creating a Pelicy 


You can create policies for any organization by using the Business Rule Composer development 
tool provided by BZ 2006. BRC helps you to create and save versions of a policy simultaneously. 
For example, let’s suppose you want to create a policy, Policy1, with the rule, PRule. You want 
the PRule rule to display the OrderedProductPrice as 5000, if the OrderedProductQuantity is 
more than 100. To create the Policy1 policy and the PRule rule, follow these steps: 


1. Click Start>All Programs>Microsoft BizTalk Server 2006Business Rule Composer to 
open the Business Rule Composer screen, as shown in Fig.Biz-5.9. 
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Fig.Biz-5.9 

2. Right-click the Policies node in the Policy Explorer pane to display context menu 
(Fig.Biz-5.9). 

3. Select the Add New Policy option to add a subnode Policy1, in the policies node that you 
want to create, as shown in Fig.Biz-5.10. 
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Fig.Biz-5.10 
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Now, click the XML Schemas tab in the Facts Explorer pane to display the Schemas node, as 


shown in Fig.Biz-5.11. 
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Fig.Biz-5.11 


Right-click the Schemas node to display a context menu and select the Browse option to 


display the Schema Files dialog box, as shown in Fig.Biz-5.12. 
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Fig.Biz-5.12 


Locate and select the schema file that you want to attach to the Policy! 
we have used the CustomerOrderSchema.xsd file. The 
CustomerOrderSchema.xsd xml file is shown in Listing 5.1 


policy. In our case, 
code for the 
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Listing 5.1: CustomerOrderSchema.xsd 


<?xml version="1.0" encoding="utf-16"?> 

<xs:schema xmIns:b="http://schemas.microsoft.com/Biztalk/2003" 

xmIns="http://RulesTest.CustomerOrderSchema" 

targetNamespace="http: //RulastTest.CustomerOrderSchema" 

xmIns:xs="http: //www.w3.org/2001/XMLSchema"> 

<xs:element name="OrderService'> 
<xS:complexType> 
<xS i Sequence> 

<xs:element name="CustomerName" type="xs:string" /> 
<xs:element name="CustomerAddressl" type="xs:string” /> 
<xs:element name="CustomerAddress2" type="xs:string" /> 
<xs:element name="CustomerCcity' type="xs:string" /> 
<xs:element name="CustomerState" type="xs:string" /> 
<xs:element name="CustomerZip" type="xs:string" /> 
<xs:element name="CustomerContactPhone” type="xs:string" 
<xs:element name="0rderedProductNumber" type="xs:string” 
<xs:element name="OrderedProductPrice" type="xs:int" /> 


<xs:element name="OrderedProductQuantity” type="xs:int" /> 


</xS: Sequence> 
</xs:complexType> 
</xs:element> 
</xs:schema> 


7. Click the Open button (Fig.Biz-5.12) to attach the located schema 


pane as shown in Fig.Biz-5.13. 


8. Change the Document Type property of |CustomerOrderSchema.xsd 


RulesTest.CustomerOrderSchema, as shown in the Fig.Biz-5.13. 
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9. Right-click the Version 1.0 (not saved) subnode under the Policy1 node in the Policy 
Explorer pane to disp!ay a context menu as shown in Fig.Biz-5.14. 


=! 3 Schemas 7 ‘i 
rf 
=) i8} CustomerOrderSchema xsc Te romey. 
+ oj) OrderService Cut 


I Microsoft Business Rule Composer - KOGENT! SULEXPRESS B12 TALK Ti NE te 


Rule Store Edit Help 


Fig.Biz-5.14 


10. Select the Add New Rule option to add the Rule1 subnode-of the rule that you want to add 
to the Policy1 policy (Fig.Biz-6.14). The Rule1 subnode is added in the Version 1.0 (not 
saved) node to the right side of Policy Explorer pane. Change the name Rule1 to PRule, as 


shown in Fig.Biz-5.15. 
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Fig.Biz-5.14 shows the Policy1 - Version 1.0 - PRule pane, which contains the IF and THEN 
panes. You can use the IF pane to specify a condition for a rule. The THEN pane allows you to 
specify the action to be performed, if the condition specified in the IF pane is satisfied. 


Now, it time to provide the condition statement in the IF and Then panes. To provide the 

condition statement, perform the following steps: 

1. Right-click the Conditions node in the IF pane to display a context menu as shown in 
Fig.Biz-5.16. 

2. Select the Predicates option to display the Predicates menu (Fig.Biz-5.16). 
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Fig.Biz-5.15 shows the Predicates menu that contains various predicates, such as Equal and 

GreaterThan. You can use these predicates to specify various conditions for a rule. 


3. Select the GreaterThan option from the Predicates menu. The arguments of the GreaterThan 
predicate appear in the IF pane (Fig.Biz-5.16). 
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Fig.Biz-5.17 
Fig.Biz-5.17 shows two arguments, argument1 and argument2, of the GreaterThan predicate 
under the Conditions node in the IF pane. 


4. Expand the OrderService subnode under the CustomerOrderSchema.xsd node in the Fact 
Explorer pane (Fig.Biz-5.17) to display various elements, such as CustomerName and 
OrderedProductQuantity of the CustomerOrderSchema schema, as shown in Fig.Biz-5.18. 


5. Drag the OrderedProductQuantity element to the argument1 argument in the IF pane 
(Fig.Biz-5.18). 

6. Click the arugument2 argument and enter the value (100) with which you want to compare 
the value of OrderedProductQuantity element (Fig.Biz-5.18). 


7. Drag the OrderedProductPrice element from the Facts Explorer pane to the THEN pane. 
The <enter a value> argument appears in the THEN pane (Fig.Biz-5.18). 
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Fig.Biz-5.18 


8. Click the <enter a value> argument and enter 5000. The 5000 value is assigned to the 
OrderedProductPrice element if the value of the OrderedProductQuantity element is 
greater than 100, as shown in Fig.Biz-5.19. 
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9. Right-click the Version 1.0 (not saved) subnode in the Policy Explorer pane to display a 
context menu as shown in Fig.Biz-5.20. 
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Fig.Biz-5.20 


10. Select the Save option to save the current version of the Policy1 policy in the BizTalk Server 
database (Fig.Biz-5.20). 


11. Close the Business Rule Composer screen. 


Now after creating the PRule rule under Policy1, it’s time to publish and test the Policy1 policy. 


Publishing and Testing a Policy 


After creating the PRule rule under Policy1, you need to publish the Policy! and test it. Publish 
the Policy1 enables you to not change the version of policy, this helps to manage the version of 
policy. Testing enables you to verify whether the rules in the policy are implemented properly. 
To publish and test the Policy1 policy, follow these steps: 

1. Open the Business Rule Composer screen. 


2. Right-click the Version 1.0 subnode under the Policy1 node to display a context menu as 
shown in Fig.Biz-5.21 
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3. Select the Publish option to publish Polieyt, On doing this, the name of Version 1.0 
subnode changes to Version 1.0 - Published, as shown in Fig. Biz-5.22 
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4. Right-click the Version 1.0 - Published node to display a context menu as shown in 
Fig. Biz-5.22, 
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Select the Test Policy option from the context menu (Fig.Biz-5.22) to display the Select Facts 


dialog box, as shown in Fig.Biz-5.23. 
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Fig.Biz-5.23 


This Fig.Biz-5.23 shows the Select Facts dialog box, which contains the Add instance button that 
you can use to attach an XML file to the Sample Rule policy. The Add instance button is 
deactivated by default, when you select a valid XML file this button will be activated. The XML 
file enables you to test the Policy1 policy. 
6. Select the RulesTest.CustomerOrderSchema subnode under the XML Documents node to 
attach the XML file to the CustomerOrderSchema schema (Fig.Biz-5.23). The Add Instance 
button is enabled after you select the RulesTest.CustomerOrderSchema node (Fig.Biz-5.25). 
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Fig.Biz-5.24 


Locate and select the XML file that you want to use to test the Policy! policy (Fig.Biz-5.24). 
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9. Click the Open button in the Open dialog box (Fig.Biz-5.24). The location and name of the 
XML file appears under the CustomerOrderSchema node in the Select Facts dialog box, as 
shown in the Fig.Biz-5.25 
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10. Click the Test button (Fig.Biz-5.25) to display Test Result to True in the Output pane of the 
Business Rule Composer screen, as shown Fig.Biz-5.26. 
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In Fig.Biz-5.26, you can see the Output pane, which shows that the test result is True, in the 
encircled area. Now, you can verify the XML file for the changed OrderedProductPrice value. 
The updated value of OrderedProductPrice in the OrderService.xml is shown in Listing 5.2. 


Listing 5.2: Updated OrderService.xml file 


<?xml version="1.0" encoding="utf-16"?> 

<nsO:OrderService xmins:nsO="http://RulesTest.CustomerordersSchema"> 
<CustomerName>CustomerName_0</CustomerName> 
<CustomerAddress1>CustomerAddressi_0</CustomerAddress1> 
<CustomerAddress2>CustomerAddress2_0</CustomerAddress2> 
<CustomerCity>CustomerCity_0</CustomerCity> 
<CustomerState>CustomerState_0</CustomerState> 
<CustomerZip>CustomerZip_0</CustomerZi p> 
<CustomerCcontactPhone>CustomerContactPhone_0</CustomercontactPhone> 
<OrderedProductNumber>OrderedProductNumber_0</OrderedProductNumber> 
<OrderedProductquantity>500</OrderedProductQuantity> 
<OrderedProductPrice>5000</OrderedProductPrice> 

</ns0O:OrderService> 


wRiek 


Now, it’s time to invoke the policy in the BizTalk application. 


>alling the Policy from an Orchestration 


After creating, publishing and testing the policy, it’s time to apply the policy to the BizTalk 
project. This is required so that the messages get exchanged on the basis of the rule mentioned in 
the policy. You can call the Policy1 policy from an orchestration. For creating an orchestration, 
you need to develop a BZ project as discussed earlier in Chapter 3. A BZ project can be 
developed by using the following steps: 


dl. 


Click Start>Programs> Microsoft Visual Studio 2005 Microsoft Visual Studio 2005 to 
open the Start Page of the Microsoft Visual Studio window. 


Select File>New~ Project on the Start Page of the Microsoft Visual Studio window to open 
the New Project dialog box. 


Select BizTalk Projects from the Project types pane, and se/ect the Empty BizTalk Server 
Project from the Templates pane. 


Next, enter the name of the BizTalk project as RulesTest in the Name textbox. 

Now, click the OK button to accept the settings. This opens the RulesTest - Microsoft Visual 
Studio window. 

Add the CustomerOrderSchema.xsd schema file to the BizTalk project. To know how to add 
the CustomerOrderSchema.xsd schema file, please refer to section ‘Adding Schema to the 
Project’ of Chapter 4. 

Right-click the  RulesTest project in the Solution Explorer and __ select 
Add New Item from the context menu to open the Add New Item — RulesTest dialog box. 
In the Add New Item — RulesTest dialog box, select the Orchestration Files node from the 
Categories pane and select BizTalk Orchestration from the Templates pane. 


Enter the name of the orchestration as Customer.odx in the Name text box. 
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10. Now, click the Add button to add the Customer orchestration item to the RulesTest project 
This opens the RulesTest — Microsoft Visual Studio screen. 


11. Set the Transaction type property of the Customer orchestration to Atomic. This is requirec 
for calling the policy and enabling the Call Rules shape in the Toolbox. 


13. Now, right-click the Messages folder on the Orchestration View pane to open the contex 
menu. 


14. Select the New Message option from the context menu to add a message to the RulesTes 
project. The Message_1 message is added to the Messages folder. 


15. Change the properties of the Message_1 message from the Properties pane according tc 
values mentioned in Table 5.1. 


Table 5.1: Properties and values of Message_1 message 


Property Value 
Identifier Corder 
Message Type RulesTest.CustomerOrderSchema (Schema Message) 


After applying these message properties, you need to add the port type by using the followings 
steps: 


1. In the Orchestration View pane, expand the Types node. 


2. Right-click the Port Types folder and se/ect the New One-way Port Type option from the 
context menu to add a new port type named PortType_1. 


3. Now, expand the PortType_1 subnode to show the Operation_1 subnode. Expand the 
Operation_1 subnode and select the Request subnode. 


4. Change the Message Type property to RulesTest.CustomerOrderSchema (Schema node 
from the Properties pane. 


After adding port type, you need to add the ports by using the following steps: 


1. In the Orchestration View pane, right-click the Ports folder and select the New Port optior 
from the context menu to add a new port named Port_1. 


2. Now, right-click the Ports folder in the Orchestration View pane to add another port. 


In this project, we need two ports. One port will be used to send messages from the Send shap 

and the other port will be used to receive messages from the Receive shape. The Send/Receiv 

shapes will be discussed later in this chapter. 

3. After this, change the properties of Port_1 and Port_2 ports in the Properties pan 
according to the values mentioned in the Table 5.2 and Table 5.3. 


Table 5.2: Properties for Port_1 port 


Property Value 
’ Port Type RulesTest.PortType_1 
Communication Direction Receive 
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When you set the value of port type is RulesTest.PortType_1 as mentioned in Table 5.2, it is 
necessary to select the Port_1 port and set its properties as well. 


Table 5.3: Properties for Port_2 port 


Property Value 
Port Type RulesTest.PortType_1 
Communication Direction Send 


When you set the value as RulesTest.PortType_1 of port type property as mention in Table 5.3, it 
is necessary to select the Port_2 port and set its properties in the Port Surface area. 


Now, the Port_1 port and Port_2 port is added in the Ports node. 


We need to add the Receive and Send shapes for exchanging messages using the ports defined. 
Shapes can be added using the following steps: 


1. Drag the Receive and Send shapes (from the BizTalk Orchestrations components on the 
Toolbox) onto the Orchestration Surface area where the point labeled Drop a shape from 
the toolbox here is indicated. 


2. Change the properties of the Receive_1 and Send_1 shapes in the Properties pane according 
to values in Table 5.4 and Table 5.5. 


Table 5.4: Property Values for Receive_1 shape 


Property Value 

Activate True 

Message Corder 

Operation Port_1.Operation_1.Request 


Table 5.5: Property Values for Send_1 shape 


Property Value 
Message Corder 
Operation Port_2.Operation_1.Request 


After entering these values, you will be presented with screen, as shown in Fig.Biz-5.27. 
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Fig.Biz-5.27 
Now, we need to add the Call Rules shape, which is required for calling the Policy1 policy 
defined earlier. You can add the Call Rules shape by dragging the same from the Toolbox anc 
drop it between Receive_1 and Send_1 shape on the Customer orchestration, as shown in the 
Fig.Biz-5.28 
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Now, you need to configure the Call Rules shape. To configure this shape, you double-click 
on the CallRules_1 shape to open the CallRules policy configuration dialog box, as shown 
in the Fig.Biz-5.29. 
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Select Policy1 from the Select the business policy you wish to call drop-down menu, as 
shown in Fig.Biz-5.30. 


A 


RS) 
~ Select the business policy you wich to calli View, 
i =") IPotcys w iQ 
Specify policy parameters: % | 
Parameter Neme Parameter Type ie 


po 


Rules Policy: (Read Only) 
Select a policy used to construct message by configuring its parameters. 


cee] see | | 
Fig.Biz-5.30 


Now, click click here to add a new row! tab (Fig.Biz-5.30) and set Parameter Name as 
Corder, as shown in the Fig.Biz-5.31 
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6. Click the OK button (Fig.Biz-5.31) to accept the settings. This will also open the RulesTest- 
Microsoft Visual Studio screen, as shown in Fig.Biz-5.32. 
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Fig.Biz-5.32 


Now, assign a strong name to the assembly and then deploy the project as discussed under 
section ‘Assignment of Strong Name to the Assembly’ and ‘Deploying the Project’ in Chapter 3. 
After deploying the project, you need to test the project. But before testing the project, you need 
to configure the project. You can configure project through the BizTalk Server 2006 
Administration Console. For configuring the project, you need to create the physical 
Send/Receive ports and locations, which are required for configuring the application in BizTalk 
Server using the BizTalk Server 2006 Administration Console. After this, bind the physical and 
logical ports and start the deployed orchestration. You also’ need to deploy the policy created 
using the BRC so that rule is applied to messages, which are getting transferred using the 
RulesTest application. 
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Deploying the Policy and Testing the Application 


Deploying a policy makes your policy available to your project. After deploying a policy, you 
need to test this policy by using an XML file in your BZ application. The created policy can be 
deployed by the following steps: 


1. Click Start>All Programs>Microsoft BizTalk Server 2006>Business Rule Composer to 
open the Business Rule Composer window, as shown in Fig.Biz-5.33. 
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a Vocabula..., 8] ¥ML Sch... | LB Databases |YYS.NET Cla Hi e To create a vocabulary definition in the Facts Explorer, click the Vocabularies tab. Right-click the 
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=) S8) Predicates 
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e To modity existing definitions, rightclick the definition node. and select Modify 
e To publish a vocabulary version, right-click the vocabulary version node, and select Publish 
Publish 3 vocabulary version before using tts definitions in business rules. 4 published vocabulary 


version cannot be modified 


® To create a new vocabulary version, rightclick the Vocabulary node. and select Add New Version 


>| Policies are logical groupings of business rules 


e To create 4 rule in the Policy Explorer, right-click the Policies node and select 4dd New Policy. A 
policy version node will be created, Rightclick the version node and select Add New Rule 


@ To define conditions, right-click the Conditions node, and select a logical operator. Drag and drop 
a builtin predicate or user defined predicate under the Conditions node or a logical operator node 
Builtin predicates can be found under Vocabularies -> Predicates -> Version 1.0 -Published. To 
define arguments of predicates or functions. drag and drop vocabulary definitions. type in their 
value. or select from a drop-down list where appropriate 


eSATA ISS 


Fig.Biz-5.33 


2. Right-click the Version 1.0-Published node to open the context menu and select the Deploy 
menu option to deploy policy1 (Fig.Biz-5.22). This will open the screen, as shown in 
Fig.Biz-5.34. 
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In Fig.Biz-5.34, you can see that the Version 1.0-Published node has changed to Version 1.0- 
Deployed. 

3. Close the BRC. 

Now it’s time to test the RulesTest project. The project can be test by the following steps: 

1. Create an XML file named as OrderService.xml with the code as shown in Listing-5.3. 
Listing 5.3: OrderService.xml file 


<?xml version="1.0" encoding="utf-16"?> , 

<ns0:OrderService xmIlns:ns0="http://RulesTest.CustomeroOrderSchema"> 
<CustomerName>CustomerName_0</CustomerName> 
<CustomerAddressi>CustomerAddressil_0</CustomerAddress1> 
<CustomerAddress2>CustomerAddress2_0</CustomerAddress2> 
<Customercity>Customercity_0</Customercity> 
<CustomerState>CustomerState_0</CustomerState> 
<CustomerZ1p>CustomerZip_0</CustomerZip> 
<CustomerContactPhone>CustomercontactPhone_0</CustomercontactPhone> 
<OrderedProductNumber>OrderedProductNumber_0</OrderedProductNumber> 
<OrderedProductQuantity>10</oOrderedProductquantity> 
<OrderedProductPrice>0</OrderedProductPrice> 

</ns0:OrderService> 
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2. Now, place the OrderService.xml file in the received location mentioned during the 
creation of a physical receive port. In our case, it is “D:\receiveORDER”. 

3. It will take sometime to move your XML file to the send location “D:\SendORDER” 
(mentioned during the creation of the physical send port). You can see the XML file will not 
have the changed value of the column  OrderedProductPrice because 
OrderedProductQuantity is less than 100. 

4. Now change the value of OrderedProductQuantity to 500 and save the OrderService.xml 
file and place the same in the “D:\receiveORDER” location. 

5. When the file has moved to the send location “D:\SendORDER”, open the XML file and you 
can see that that the value of OrderedProductPrice has changed to 5000 (as per the PRule 
rule defined in BRC). 

With this, we come to the end of this chapter. What follows is a brief summary of the main 

points covered in the chapter. 


Summary 


In this chapter, we discussed BZ business rules and policies. We also discussed the installation of 
the Business Rule Composer and learned how to create, publish, deploy and test a policy by 
using an XML schema in detail. At the end of the chapter, we learned to call the policy from an 
orchestration by developing a BZ project. 

In the next chapter, we will discuss B2B business processes and learn how to conduct online 
trading through the B2B e-commerce process. 
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Business-to-Business (B2B) process is a term used to describe electronic commerce 

transactions between businesses. It is used for exchanging products or services among 
different companies. Companies conduct B2B transactions in an online market, which involves 
buy-side and sell-side solutions in addition to trading exchanges of online products and 
marketplaces. Buy-side and sell-side solutions are a set of applications that allow companies to 
purchase or sell their products or services online. Business protocols are sets of rules in data 
exchange format that are implemented using different standards, such as EDI, Open Catalog 
Interface (OCI) and Commerce eXtensible Markup Language (cXML). These business protocols 
are used by companies to communicate with each other and perform B2B transactions. Business 
protocols specify the format for messages, such as purchase orders (POs) and invoice in each 
standard used for performing the B2B process. 


This chapter explains the traditional business process of conducting B2B transactions and B2B e- 
commerce. It also explains B2B exchange, B2B hub architecture, and buy-side and sell-side 
solutions. In addition, the chapter explains the data exchange formats that are used for 
communication in a B2B transaction. 


The B2B Process 


Nowadays, a majority of companies perform their business activities through B2B e-commerce 
instead of the traditional B2B system. In the traditional B2B process, companies face many 
problems such as high cost of business transactions, ineffective use of time to perform business 
activities, and lack of sufficient manpower. For example, in traditional B2B processes, 
companies use traditional methods, such as telephone and fax to perform their business 
activities. These traditional methods require more time and are costlier to perform as compared 
to companies that use B2B e-commerce methods, such as the Internet to conduct their business 
activities. 


In B2B e-commerce, companies perform their business activities with trading partners and 
supplier Companies by using the Internet or dedicated Virtual Private Network (VPN) links. 
Companies automate business activities by using different packaged and web applications that 
provide online transaction of products and services within quick response time and are cost 
effective too. Automating business activities help companies maintain a consistent and effective 
relationship with their trading partners. 


Now, we will discuss traditional B2B process in detail. 


The Traditional B2B Process = 


In the traditional B2B process, different employees of a company perform their business, such as 
preparing of PO, sending of invoice and preparation of bill. For example, an employee of a 
supplier company sends Request For Quotations (RFQs) that are compiled by an employee in the 
buyer company. Another employee in the buyer company prepares the PO and sends it to the 
supplier company. Fig.Biz-6.1 shows the traditional B2B process: 


150 


Chapter 6: Overview of B2B Process 


Company A Company B 
Oy iC} 
Y RFQ mr 
a P . 
Sending RFQ PO Flow Compiling RFQ 
G (Phone/Fax/Mail) Co i 
; > 2 internal Workflow 
PO Acknowledgement La 
(Phone/Fax/Mail) ; tndent 
Accepting and w Raising PO 
Processing PO ¢ 
®) lavoice = 
; o) Material Management 
Phone/Fax/Mail ad 
|_(PhonemFaxmai) 5) 
a Payment 
Creating and “ 
Raising Invoice Process Invoice Account 
and Generate + 
Payment 
| Purchase 
Approval 
’ Cost 
Time| Resource/ Error 
Phone/Fax 
Fig.Biz-6.1 


This figure shows the traditional B2B process in which different employees of Company A and 
Company B perform various tasks, such as sending POs, receiving invoices from the partner, 
constructing a payment voucher of the partner, and receiving the payment. The traditional 
business process has following limitations: 


Q Communication between trading partners and supplier companies are performed through 
traditional systems, such as telephone, mail, and fax. 


Q Increased overhead costs of business activities, because a company needs large number of 
employees to perform its business activities. 


Q Time-consuming process, because all the tasks are performed manually by different 
departments of the company. 


Q All the tasks are performed manually by the employees of the company. Thus, errors can 
occur in tasks such as preparing PO, sending invoices, and preparing bills. 


After understanding traditional B2B process, let’s understand the concept of the B2B e- 
commerce process. 


The B7B E-Commerce Process 


In the B2B e-commerce process, a set of products and services facilitates the exchange of 
products, services and information over electronic networks within a company, and between 
companies and their customers. To conduct B2B e-commerce, companies integrate with buyers 
and suppliers and perform business activities such as buying and selling of products or services 
by using electronic systems, such as software applications and computers. To perform B2B e- 
commerce: 
1. The buyer company first connects to a B2B exchange using the Internet. A B2B exchange is 
an online market place where companies buy and sell products and services from and to 
other companies. 
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2. The buyer company looks at product catalogs of various supplier companies for products or 
services that it wants to buy. 


3. After looking at the catalogs, the buyer company identifies the supplier companies that offer 
good quality products at competitive prices. Having done this, the buyer company sends 
POs to the concerned supplier companies. 


4. The supplier companies send an acknowledgment for the receipts of the POs and prepare 
invoices for them. The invoices and advance shipment notifications are sent to the buyer 
company. 

5. The buyer company receives the invoices and sends an acknowledgement for them to the 
supplier companies. It then processes the invoices and sends payment to the supplier 
companies. 


Fig.Biz-6.2 shows the B2B e-commerce process: 
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Fig.Biz-6.2 


This figure shows the B2B e-commerce process in which buyer companies, such as Buyer A and 
Buyer B, connect to the B2B exchange to access product catalogs of supplier companies. The 
various Components involved in the B2B e-commerce process are: 


Q  B2B exchange 
Q E-marketplace 
Q B2B partners 


Q Data exchange formats and specifications 
Let’s now look at each in detail. 


B2B Exchange 


B2B exchanges are simply online marketplaces where buyers and sellers offer products and 
services and conduct business transactions. It enable companies to easily find the goods they 
need, complete the transaction, and save money in the process by using the online shopping 
system through the Internet. Various types of B2B exchanges exist. Some of the common ones 
are: 
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Q Consortia: This type of B2B exchange is used by a group of vendors of a specific industry. 


For example, Global Food Exchange is a consortia exchange where a group of vendors 
related with the food products industry perform business activities. 


Q Public: This type of B2B exchange is open to all companies. The public exchange can be 
used by any company that wants to sell and purchase products at competitive prices. A 
Customer can view their products on the websites of different companies and select those, 
which best suit his or her budget. Commerce One is an example of a public exchange. 


Q Private: This type of B2B exchange is run by a single company. The exchanges run by Wal- 
Mart and Dell are examples of a private exchange. 


Q = Vertical: This type of B2B exchange is used by a specific industry. In this type of B2B 
exchange, services are provided to a single industry. Here, you can take the example of an 
exchange used by the steel industry, which includes all different levels within that industry, 
right from suppliers of raw material through the production of components and finished 
goods to customers. 


Q Horizontal: Horizontal type of B2B exchanges are used by multi-industries. These are useful 
when several industries have a common need for particular kinds of inputs, services or share 
particular problems. For example, an exchange related to stock market is a horizontal type of 
exchange. 


E-Marketplace 


E-marketplace is an online exchange that provides services, such as auctioning and tendering to 
buyer and supplier companies. It is a trading platform created with a collection of searchable 
web services to enable trading partners conduct business activities over the Internet. E- 
marketplaces provide a place for buyer and supplier companies to market their products and 
services. Web services provide a standardized way of integrating web-based applications using 
XML standards over the Internet. The various e-marketplace services are: 

Q Supplier directories and search engines 

Q Tendering 

Q Classifieds 


Q Auctions 


Let’s discuss these services one by one. 


Q Supplier directories and search engines: In supplier directories and search engine services, 
databases containing data related to supplier companies are maintained. A buyer company 
can use this service to identify supplier companies and buy products and services from them. 
A buyer company can use the databases to search for supplier companies selling the 
products they need. 


Q Tendering: The tendering services maintain a database containing data related to tenders 
declared by different buyer companies. There are two types of tendering services-- public 
and open. The public tendering service is used by government institutions to declare tenders 
for purchasing products and services. The open tendering service is used by a company to 
declare tenders for purchasing products and services. 
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Q Classifieds: The classifieds service help a supplier company provide information related to its 
products that are for sale. A supplier company provides advertisements about its products in 
the magazines that are published on different websites in the form of classifieds. 


Q Auctions: The auction service helps a supplier company to sell its products or services by 
auctioning them to the highest bidding company. This helps a supplier company to obtain 
the highest prices for its products or services. The auction service helps a buyer company to 
find bargains for products or services it wants to purchase. The reverse auction service, on 
the other hand, enables a buyer company to find a supplier company. that offers the lowest 
price for the products or services it wants to buy. In the reverse auction service, supplier 
companies continue to decrease the prices of their products and services to obtain contracts 
from buyer companies. Supplier companies offering the lowest prices obtain the contracts 
from the buyer company. The reverse auction service is also called sourcing or buyer 
auction. 


B2B Partners 


A B2B partner represents a company from which another company purchases or sells its 
products or services. A company and its B2B partners use buy-side and sell-side solutions to 
purchase or sell products and services in a B2B exchange and e-marketplace. Companies use the 
B2B hub architecture to exchange information with B2B partners. The architecture of a B2B hub 
is described next. 


The B2B Hub Architecture 


The B2B hub architecture is based on the any-to-any business document exchange model. The 
any-to-any business document exchange model is used to exchange documents in any format, 
such as XML or American National Standards Institute (ANSI) X12 EDI, among different B2B 
applications. The B2B hub architecture integrates the applications running in companies by 
using a common message-processing hub. The message-processing hub receives messages from 
an application, processes it and sends it to another application. Fig.Biz-6.3 shows the B2B hub 
architecture. 
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This figure shows the B2B hub architecture in which a buyer company sends messages, such as 
PO and RFQ, through the B2B exchange to a hub. 


Next, we will discuss B2B buy-side and seli-side solutions that provide B2B transactions between 
B2B trading partners. 
82B Buy-side and Sell-side Solutions 


Companies use buy-side and sell-side solutions to perform B2B e-commerce with their partners. 
A buy-side solution is a group of B2B web applications that run on a buyer company. In addition 
to setting workflow and internal routing of products, buy-side solutions help perform tasks, such 
as sending of POs, and acknowledging receipts of invoices. A buy-side solution is used for 
performing the following tasks in B2B e-commerce: 


Q Managing the internal workflow of a buyer company by approving material requirement 
raised by an employee or a department. 


Q Performing Maintenance Repair and Operations (MRO) services in a buyer company. 
Q Extracting and comparing data from catalogs of different supplier companies. 
A buy-side solution provides the following benefits to the buyer company: 


Q It reduces the cost of administration. 


OQ It reduces the number of times a purchase cycle is performed. 
Q It helps manage the stock of products and services required by a buyer company. 


A sell-side solution is a set of applications that run on the supplier side and allows a buy-side 
solution to connect to it directly or through a B2B exchange. A buyer company can obtain 
complete information related to a product or service sold by the supplier company by using the 
sell-side solution. A B2B exchange allows a supplier company to publish only limited 
information, such as product name, product ID, or product price. As a result, the supplier 
company can customize its sell-side solution to allow a buyer company to directly connect with 
it and obtain information related to its products and services. Alternatively, a buyer company can 
obtain supplier information through a channel, such as B2B exchange or e-marketplace. 


Now, we will discuss data exchange formats and specifications in detail. 


Data Exchange Formats and Specifications 


B2B data exchange and transactions are performed through standard data exchange formats used 
to exchange documents among B2B partners. For a B2B transaction, the B2B partners need to 
define one or more specific data exchange formats and all the trading partners must be 
compatible with the selected formats. BZ 2006 supports various data exchange formats for B2B 
transactions. The data exchange formats supported by BZ 2006 are: 


Q American National Standards Institute (ANSI) X12 


Q United Nations Rules For Electronic Data Interchange For Administration, Commerce, and 
Transport (UN/EDIFACT) 


Q Open Catalog Interface (OCI) 
Q Commerce XML (cXML) 
Let’s look at each format in some detail. 
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American National Standards Institute (ANSI) X72 


American National Standard Institute (ANSI) X12 is based on the Electronic Data Interchange 
(EDI) standard that transmits a document into different B2B applications. The document 
transmitted in ANSI X12 format is structured into three levels. These are: 


Q 


Q) 
Q) 


Transaction set: Contains one or more data elements that are used to transfer information 
from one B2B application to another. 


Functional group: Contains one or more transaction sets. 


Interchange: Contains one or more functional groups. 


A number of segments are required to transmit each document in an ANSI X12 format. These 
segments provide specific information about the document. The various segments in an ANSI 
X12 document are: 


Q 


Interchange Control Header (ISA): This segment acts as a header that represent the start 
point for an interchange document (Interchange documents allow you to easily store and 
access your documents online). It also provides information, such as name and ID, about the 
sender and the recipient of a document. 


Function Group Header (GS): This segment acts as a header and represents the start point 
for a functional group (A functional group contains one or more transaction sets. See 
introduction to ANSI X12 in this chapter). The information provided by this segment 
includes code to identify a specific message and a unique reference number assigned to a 
functional group. 


Transaction Set Header (ST): This segments acts as a header and specifies the start point for 
a transaction set. It also provides information about the type of transaction set and a unique 
reference number assigned to a transaction set. 


Transaction Set Trailer (SE): This segment acts as a trailer that specifies the endpoint for a 
transaction set. This segment provides the total number of elements in a transaction set and a 
reference number. This reference number must be the same number as specified in the ST 
segment. 


Function Group Trailer (GE): This segment acts as a trailer that specifies the endpoint for a 
functional group. This segment also specifies the total number of transaction sets in a 
functional group and a reference number. This reference number must be the same number 
as specified in the GS segment. 


Interchange Control Trailer (IEA): This segment acts as astrailer that specifies the endpoint 
for an interchange. This segment also specifies the total number of functional groups in an 
interchange and a reference number. This reference number must be the same number as 
specified in the ISA segment. 


Table 6.1 shows the structure of a sample ANSI X12 invoice document: 
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Table 6.1: Structure of a Sample ANSI X12 Invoice Document 


Beginning 
Segment for 
Invoice 
(BIG) 


Currency 
(CUR) 


Name, 
Address, 
Geography, 
N1, N2, N3 
& N4 


Admin. 
Comm. 
Contact 
(PER) 


Terms of 
Sale (ITD) 


Reference 


Ship Date 


BIG*980221*10011 
1**E00012345 
<CR> 


CUR*SE*USD 
<CR> 


N1*BT*ABC 
Corporation* 92*IT 
L1 <CR> 


N3*PQ Box 1000 
<CR> 


N4*New 
Delhi*0R*97124*1 
NDIAINDIA <CR> 


Ni*ST*ABC 
Corporation <CR> 
N3*5300 Ansari 
Road, Daryaganj 
<CR> 

N4*New 
Delhi*0R*97124*1 
NDIA <CR> 


N1*SF*Acme Co. 


N3*987G-Block. 
<CR> 
N4*Main 
City*OR*97000 
<CR> 


PER*AD*Till 
Acme*TE*5035554 
321<CR> 


1TD*01*3*2**10** 
30 <CR> 


REF*61*999 
<CR> 


DTM*011*960131 
<CR> 


Invoice Date: January 21, 2008 

Invoice Number: 100140 

Purchase Order Number: E000125 
Document Type (not on invoice) DI, CR, DR 


Currency information (not on invoice) 


Bill to: ABC Corporation 

ID Code Qual: 92 (not on invoice) 
ID Code: ITL1 (not on invoice) 
Address: PO Box 1000 

New Delhi, OR 97124-1000 


Ship to: ABC Corporation 
Address: 5300 Ansari Road, Daryaganj 
New Delhi, OR 97124 


Ship From: Acme Co. 
Address: 987 G-Block, South Ext, New Delhi OR 97000 


Contact Name: Till Acme 
Telephone: 503.555.4321 


Terms of Sale: 2% 10, net 30 days 


Reference Invoice number 999 


Date Shipped 1/31/1996 
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Table 6.1: Structure of a Sample ANSI X12 Invoice Document 


DETAIL 
(Line Item) 


Invoice 
data, IT1 


Product 
Description 
(PID) 


Reference 
Number 
{REF) 


Invoice 
data, IT1 
(Line item 
Detail) 


Product 
Description 
(PID) 


Reference 
Number 
(REF) 


SUMMARY 


Total 
Invoice 
Amount 
(TDS) 


Tax Info 
(TXI) 


Carrier 
Detail (CAD) 


Special 
Handling/Freight 


Transaction 
Totals (CTT) 


Transaction 
Set Trailer 


1T1*1*10*EA*5.00 
**BP*X1234 
<CR> 


PID*F *Widgets 
<CR> 


REF*GL* 12345678 
9*AMT5000 
<CR> 


1T1*1*5*EA* 20.00 
**BP*Y9999 
<CR> 


PID*F ~ Wombats 
<CR> 


REF*GL*12345678 
9* AMT10000 
<CR> 


TDS*19000 <CR> 


TXI* ST*70 
00<CR> 


CAD*M**** ABC 
Truck <CR> 


SAC*C*D240*3000 
*Freight 


CTT*2 <CR> 


SE*27*000001 
<CR> 


Quantity Unit of Unit Product Part 
Measure Price Desc # 
10 EA 5.00 Widgets X1234 


“F” for free form message. 
Product Description: Widgets 


Reference Number: General Ledger number (not on invoice) 
Distribution description: Amount 


5 EA 20.00 Wombats 9999 


Product Description: Wombats 


Reference Number: General Ledger number (not on invoice) 
Distribution description: Amount 


Total Due: 190.00 (Implied 2 place decimal point) 


Sales Tax Due: 10.00 
Carrier Info: ABC Truck r 


Shipping and Handling $30.00 
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Table 6.1 shows the structure of different ANSI X12 documents. Each ANSI X12 document is 
specified with a specific format. 


Table 6.2 shows commonly used formats for different ANSI X12 documents. 


Table 6.2: ANSI X12 Document Formats 


Document 
Price/Sales Catalog 
Purchase order 

PO Change 

PO Acknowledgment 
Invoice 

Payment Order 
Request for Quotation 


Forecast 


ANS! X12 Format Specification 


860 
855/865 
810 
820 
840 
830 


United Nations Rules For Electronic Data Interchange For Administration, Commerce, and Transport 


(UN/EDIFACT) 


UN/EDIFACT is an EDI standard used to transmit documents among different computer 
applications. Table 6.3 shows the various UN/EDIFACT document formats: 


Table 6.3: UN/EDIFACT Document Formats 


UN/EDIFACT Document 
PAYORD 


REQOTE 


QUOTES 
IFTSTA 
INVOIC 
ORDCHG 


ORDERS 
ORDRSP 


Area 


Finance 


Trade 


Trade 
Transport 
Trade 


Trade 


Trade 


Trade 


Description 


Represents the format of a payment order 
document. 


Represents the format of a quotation request 
document. 


Represents the format of a quotation document. 
Represents the transport status of a PO. 
Represents the format of an invoice. 


Represents the request to change a PO. 


Represents the format of a PQ. 


Represents the response for a PO. It specifies 
whether the PO has been completed or not. 
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Table 6.3: UN/EDIFACT Document Formats 


OSTENO Trade Represents the format of a PO status inquiry 
document. This document specifies the status of 
a purchase order. 


OSTRPT Trade Represents the format of a PO status report 
document. 

PARTIN Trade Represents the format of a buyer information 
document. 


Documents used in the UN/EDIFACT format are structured into three levels. These are: 


Q 
Q) 
Q 


Interchange: This level contains one or more functional groups. 
Functional group: This level contains one or more messages. 
Message: This level represents an ordered series of characters used to transmit information. 


Each UN/EDIFACT document contains different segments with specific information about the 
document. The following segments are used in an UN/EDIFACT document: 


Q) 


Service String Advice (UNA): This is an optional segment in the UN/EDIFACT document. 
This segment defines the characters that act as separators and indicators, such as a plus sign 
or a colon in a message. 

interchange Header (UNB): This segment represents a header and specifies the start point 
for an interchange. This segment also specifies information, such as name and ID, about the 
sender and the recipient of a document. 


Functional Group Header (UNG): This segment acts a header and specifies the start point 
for a functional group. It also provides information, such as code to identify a specific 
message and the unique reference number assigned to a functional group, about the 
functional group. 

Message Header (UNH): This segment acts as a header and defines the start point of a 
message. It provides information such as the type of a message and the unique reference 
number assigned to a message. 


Message Trailer (UNT): Message trailer acts as a trailer and specifies the endpoint of a 
message. This segment provides information such as total number of segments in a message 
and a reference number. This reference number must be,the same number as specified in the 
UNH segment. 


Functional Group Trailer (UNE): This segment acts as a trailer that specifies the endpoint for 
a functional group. This segment provides information such as the total number of messages 
in a functional group and a reference number. This reference number must be the same 
number as specified in the UNG segment.Interchange Trailer (UNZ): This segments acts as 
a trailer and specifies the endpoint for an interchange. The UNZ segment provides 
information such as the total number of messages or functional groups in an interchange and 
a unique reference number. This reference number must be the same number as specified in 
the UNG segment. 


Listing 6.1 shows the sample ORDERS file for a UN/EDIFACT document: 
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Listing 6.1: The Sample ORDERS File 


1 UNB+UNOB: 1+003897733:01:MFGB-PO+PARTNER 
ID: ZZ+970101: 1050+00000000000916++ORDERS 
2 UNH+1+ORDERS:S:93A:UN 
3 BGM+221+P1M24987E+9 
4 DIM+4:970101:101 
5 FIX+PUR+3++PURCHASE ORDER BEFORE LINE ITEM INSTRUCTIONS 
6 RFF+CT:123-456 
7 RFF+CR:1 
8 NAD+SE+8049P: :92++SUPPLIER NAME 
9 NAD+BT+B2::92++ABC COMPUTER CORPORATION+P O BOX 92000+HOUSTON+TX+77692000+US 
10 NAD+BY+B2::92++ABC COMPUTER CORPORATION 
11 NAD+ST+CM6: :924++ABC COMPUTER CORPORATION+CCM6 RECEIVING DOCK:20555 SH 
249+HOUSTON+TX+77070+US 
12 CTA+PD+:CLARETTA STRICKLAND-FULTON 
13 CTA+SR+:STEVE 10/19/92 
14 TAX+9++++++3-00105-5135-3 
15 CUX+2:USD:9 
16 PAT+1+41:1:D:45 
17 PAT+22+4+1:1:D:30 
18 PCD+12:2 
19 TDT+20+++4+: : : AIRBORNE 
20 LOC+16+COMPAQ DOCK 
21 TOD+2+CC+:::ORIGIN COLLECT 
22 LIN+900001++107315-001:BP 
23 PIA+1+AA:EC+123456: VP f 
24 IMD+F+8+:::PART DESCRIPTION INFORMATION 
25 QTY+21:10000000: PCE 
26 DIM+2:970301:101 
27 FTX+LIN+3++LINE ITEM COMMENTS 
28 PRI+CON:50 
29 UNS+S 
30 UNT+29+1 
31 UNZ+1+000000000000916 


Open Catalog Interface (OCI) 


Open Catalog Interface (OCI) is a data exchange format used with a web browser to exchange 
information between a catalog and a buyer. It is implemented in System, Application, and 
Product (SAP). SAP is an enterprise resource planning (ERP) software capable of integrating 
multiple business applications, with each application representing a specific business area such 
as supply chain management, customer relationship management, and supplier relationship 
management. The documents in the OCI format are divided into two sections, outbound and 
inbound. 


Q The Outbound Section: The outbound section consists of information, such as catalog URL 
and login data that is being sent from a buyer application to a catalog application. When a 
user selects a product catalog from the web browser, the buyer application uses the 
information such as the URL of the outbound section. The web browser then directs the 
product catalog from the buyer application to the catalog application and displays the 
catalog homepage. The information in the outbound section is structured in a specified 
format, as shown in Table 6.4: 
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Table 6.4: Formats in the Suthound Section 


Formats Field Name 


Catalog URL <blank> 


All catalog-specific 


fields 

Return URL HOOK_URL 
Caller -CALLER 
OK code -OkCode 
Target -TARGET 


format, as shown in Table 6.5: 


Table 6.5: Formats in the Inbound Section 


Field Name 
Type 
Fixed 


Variable 


Variable 


Fixed 


Fixed 


Fixed 


Catalog item Item name 

Description NEW_ITEM-DESCRIPTION 
Product master NEW_ITEM-MATNR 
Product Group NEW_ITEM-MATGROUP 
Quantity NEW_ITEM-QUANTITY 
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Description 


Specifies the jiocation of a 
catalog application. 


Specifies a set of fields, such as 
request type and password, for a 
catalog application. 


Contains the URL of a buyer 
application. 


Represents the data sent by an 
external catalog. 


Contains the transaction code, 
which indicates that the items 
are added into the shopping 
basket. function. 


Specifies a frame into which a 
catalog is to return in a frame- 
based environment. 


The Inbound Section: The inbound section consists of information sent by a catalog 
application to a buyer application. When a user selects a catalog from a web browser, the 
catalog application generates a document containing the catalog in the HTML format. The 
catalog application uses the document and redirects it to the web browser to display the 
data of the buyer application. The catalog in the inbound section is structured in a specified 


Description 


“Represents information about 


ordered catalog items. 


Represents the SAP _ product 
master number. 


Represents the group number of a 
SAP product. 


Represents the number of 
ordered catalog items. 
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Table 6.5: Formats in the Inbound Section 


Currency 


Lead time 


Vendor product number 


Customer-specific field 


Contract number 


Item of a contract 


Unit of measure 


Price 


Vendor 


Manufacturer code 


Manufacturer product number 


Service flag 


Quotation 


Quotation item 


NEW_ITEM-CURRENCY 
NEW_ITEM- LEADTIME 
NEW_ITEM-VENDORMAT 


NEW_ITEM-CUST_FIELD 


NEW_ITEM-CONTRACT 


NEW_ITEM- 
CONTRACT_ITEM 


NEW_ITEM-UNIT 


NEW_ITEM-PRICE 


NEW_ITEM-VENDOR 


NEW_ITEM- 
MANUFACTCODE 


NEW_ITEM-MANUFACTMAT 
NEW_ITEM-SERVICE 


NEW_ITEM-EXT_QUOTE_ID 


NEW_ITEM- 
EXT_QUOTE_ITEM 


Represents the ISO code for 
currency. 


Represents the number of days 
the catalog item is available. 


Represents the product number 
of a seller catalog item. 


Represents customer information 
such as name, address, and so 
on. 


Represents the contract number 
with the supplier company. 


Represents the number of items 
for which a contract is signed 
between a buyer and a supplier 
company. 


Represents the unit of measure 
for a catalog item. 


Represents the price of an item in 
a catalog. The price value of an 
item must have three digits to the 
right of the decimal point and can 
have a maximum of 11 digits to 
the left of the decimal point. 


Represents the trading partner 
number in a B2B procurement 
system. 


Represents the manufacturer 
code number. 


Represents the product number 
of a manufacturer catalog 
product. 


Represents a flag indicating 
whether the item name refers to 
a service or a product. 


Refers to an external quotation. 


Refers to an external quotation 
item. 
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Table 6.5: Formats in the Inbound Section 


Product ID NEW_ITEM- Represents a value to identify a 
EXT_PRODUCT_ID specific item in the catalog. 

Description NEW_ITEM- Defines the description of a 
LONGTEXT_n:132 product. 


Commerce XML (cXML) 


Commerce XML (CXML) is an XML based protocol specifically designed for B2B e-commerce. It 
is based on XML standards to help exchange documents among different B2B partners. B2B 
partners use CXML to create different documents, such as electronic catalogs, purchase orders 
and invoices required for a business process. The following models are used to exchange CXML 
documents among B2B partners: 


OQ Request-Response model 
Q One-Way model 


Q The Request-Response Model: In this model, the HTTP protocol is used for transacting 
cXML documents among B2B partners. In this model, a B2B partner (trading partner A) uses 
the Request document to send a specific request message to another B2B partner (trading 
partner B). Trading partner B uses the Response document to send a response of the Request 
document, to trading partner A. Fig.Biz-6.4 shows how cXML documents are exchanged in 
the Request-Response model: 


‘ Request 


Trading Trading 


Partner A Partner B 


Response 


Fig.Biz-6.4 


This figure shows the transaction of CKML Request and Response documents between trading 
partners A and B. The CXML Request document contains a specific request and information to be 
transacted from trading partner A to trading partner B. Listing 6.2 shows the structure of a CXML 
Request document. 


Listing 6.2: Structure of a CXML Request Document 


<CXML> 
<Header> 
Header information here... 
</Header> 
<Request> 
Request information here... 
</Request> 
</CXML> 
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This listing shows the structure of a CXML Request document, which contains two sections: , 
Header and Request. The Header section contains credential information, such as ID and 
password of a request user, and the Request section contains a specific request. 


The cXML Response document contains the response for the CXML Request document. 
Listing 6.3 shows the structure of a CXML Response document: 


Listing 6.3: Structure of a CML Response Document 


<CXML> 

<Response> 

Response information here 
</Response> 

</CXML> 


This listing shows the structure of a CXML Response document containing the Response section, 
which in turn contains the Response document. 


Q The One-Way Model: In the One-Way model, cCXML documents are encoded in a specific 
protocol for transmitting documents to different B2B partners. Transmitting CML documents 
in the One-Way model is not limited to the use of the HTTP protocol. Fig.Biz-6.5 shows 
how cXML documents are exchanged by using the One-Way model: 


Trading Message Arading 


Partner A Partner B 


Fig.Biz-6.5 
This figure shows the transaction of a CXML document from trading partner A to trading partner 
B. The documents in this model are transmitted in the following way: 


Q Trading partner A formats and encodes a cXML message that is to be transferred to trading 
partner B. 


Q Trading partner A sends the message using a known protocol such as HTTP and does not 
wait for a response from trading partner B. 


Q Trading partner B receives the cXML message and decodes it. 
Q_ Trading partner B processes the message. 


The One-Way model commonly uses the HTTP and URL-FORM-Encoding protocols for 
transmitting CXML documents. Listing 6.4 shows the structure of a One-Way message document: 


Listing 6.4: Structure of a One-Way Message Document 


<CXML> 

<Header> 

Header information here... 
</Header> 

<Message> 

Message information here... 
</Message> 

</CXML> 
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This listing shows the structure of a One-Way message document that contains two sections, 
Header and Message. The Header section contains credential information and the Message 
section contains the specific message. 

After learning about CXML, let’s move ahead and find out how to perform B2B transactions on 
the Internet. 


Open Buying on the Internet (OBI) 


Open Buying (OBI) on the Internet is a proposed standard that provides an open, flexible, and 
secure framework for B2B transactions on the Internet. It is aimed to be high-volume, low-cost 
per item transaction and uses a number of security technologies such as a digital certificate to 
allow orders to be placed and filled securely. The OBI architecture is built on existing standards, 
such as the X12 850 EDI and X12 855 EDI standards. The OBI architecture contains the 
following four entities for a transaction process: 


Q Requisitioner 
Q Selling company 
Q Buying company 


Q Payment authority 


In the OBI architecture, a requisitioner at a buying company uses a web browser to access a 
specific product catalog from the supplier website to place an order. After accessing the product 
catalog, the requisitioner selects a product and places an order. 


Selling 
Organization 


Requisitioner 


ie 


Buying Payment 
Organization Authority 


Fig.Biz-6.6 


Fig.Biz-6.6 shows the OBI architecture for a transaction process with four entities. These entities 
are explained as follows: 


Q Requisitioner: The requisitioner represents the person who actually places the order. The 
requisitioner is affiliated with a buying organization and has access to a desktop machine 
with a web browser and the Internet. The requisitioner also has a digital certificate, issued by 
a trusted certificate authority. 
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Q Buying Organization; The buying organization represents systems, which support 
purchasing information. These systems include an OBI server for receiving OBI Order 
Requests and returning OBI Orders, and also handling the requisitioner profile information, 
trading partner information, account, and tax status information. The buying organization 
also maintains contractual relationships with preferred selling organizations. 


Q Selling Organization: The selling organization maintains a product catalog that presents 
product and price information. This information can be viewed based on organizational 
affiliation of the requisitioner as specified in a digital certificate. Product and price 
information reflects the contract with a buying organization. Selling organizations must be 
able to authorize certain transaction types with the appropriate payment authority. 


Q Payment Authority: Payment authorities provide authorization for the payment presented by 
the requisitioner. Payment authorities must provide payments to selling organizations and 
timely debit to the buying organization. Payment authorities may include a variety of 
financial institutions and if the payment authority is a bulk invoice, selling organizations 
assume the responsibilities of a payment authority. 


Summary 


In this chapter, we compared the traditional and the e-commerce methods of doing business-to- 
business or B2B transactions among different companies. We also discussed the B2B e- 
commerce process, which has become the preferred way of conducting business transactions 
through the internet. We discussed the various components involved in the B2B e-commerce 
process, such as B2B exchange, e-marketplace, B2B partners, B2B hub architecture and various 
data exchange formats used to perform B2B transactions. 


Now that you have an overview of B2B process let’s move on to next chapter, where we will 
learn how to troubleshoot the BizTalk application and handle errors that usually occur during 
the development stage by using different tools available in BizTalk Server 2006. 
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es may sometimes find that your BizTalk Server displays errors while transmitting messages 
or while an application is being deployed on BizTalk Server. To resolve these errors, you 
need to troubleshoot the application for errors. For this, you need a utility to help them identify 
these errors. In BizTalk, this role is performed by the Health and Activity Tracking (HAT) tool. 
HAT is used for monitoring the health of BizTalk Server and its applications. By using this tool, 
you can easily locate the errors in the application, identify their cause, and rectify them by 
following some simple steps. 


This chapter familiarizes you with the working of the HAT tool. This is followed by a detailed 
discussion on troubleshooting some of the common errors that occur in installing, configuring, 
and administrating BizTalk Server. 


Health Monitoring 


The health monitoring tool of BizTalk Server 2006 is used to check or monitor the health of the 
BizTalk application. The main objective of monitoring the BizTalk application is to find and 
diagnose the problems occurring in the application and correct them. The health monitoring tool 
detects these problems, analyzes them and suggests ways of resolving them. Some of the 
common problems in BizTalk are related to invalid messages, ports, and orchestrations. 


The HAT tool is used to debug orchestrations in the BizTalk application. In addition, it also 
keeps track a message and provides detailed information about it, including its size, its status 
(that is, whether the message was transmitted successfully or met with failure), its start time (time 
the orchestration or pipeline started), its end time (time the orchestration or pipeline was 
completed) and its duration (the time it took for the entire operation to be to completed). Apart 
from providing this information, the HAT tool also keeps track of schemas, ports and 
orchestrations used in the BizTalk application. We can also use BizTalk Server Administrator 
Console, and Event Viewer to monitor the health of the BizTalk application. 


We will now discuss HAT in detail in the next section. 


Using Health and Activity Tracking (HAT) 


The Heath and Activity Tracking (HAT) tool helps you to monitor your BizTalk application. HAT 
is used for different purposes by different people. System administrators use the HAT tool to track 
and monitor BizTalk implementation, or view details pertaining to message flow. Business users, 
on the other hand, use HAT to view, monitor and query tracked data. The main features of HAT 
are as follows: . 


Q Tracking Message Flow: Message flow can be defined as a series of contiguous processing 
steps taken by a message. The Message Flow view of HAT shows you the sent and received 
messages of a service instance (pipeline, port or orchestration), with details such as the URL, 
port, and party used. You can track the message flow and use the information available to 
troubleshoot errors. 


Q Find Message for tracking: You can use HAT’s Find Message feature to search for specific 
messages. HAT can retrieve messages by using either data or system information. After 
finding the message, you can view the information for errors and troubleshoot the same. 

Q = Archived and Live Data for troubleshooting: Archived data is the backup of data that is no 
longer used. You can analyze archived data using archiving views to check past data related 


170 


Chapter 7: Troubleshooting the BizTalk Applications 


to both your business and your system. Live data, on the other hand, is the currently active . 
data stored on the BizTalk Tracking database and shown by views. Any error in Live Data 
can be rectified by using Archived Data. 


Q Orchestration Debugger: HAT also enables real-time debugging of orchestrations. With the 
help of this feature, you can set breakpoints to a class or suspended orchestration, view both 
offline and live data, and view all the steps to design the orchestration again. A breakpoint is 
a stopping or pausing place of an orchestration that is used for debugging the orchestration. 


You can track the overall performance of an orchestration with the help of HAT. You can view a 
message’s technical details such its status, its start time, its end time, the number of sent or 
received messages, and the queries executed on BizTalk Server Database. You can use the 
following techniques or options to monitor the BizTalk application with HAT: 


Q The Find Messages technique or option 

The Query Builder technique or option 

The Message Count in Past Week technique or option 
The Message Count technique or option 


Co bb 8 


The Message Received in Past Day technique or option 
Let us now discuss these one by one in detail. 


The Find Message Technique 


This technique is used to find out which messages are running under which applications. It 
displays information regarding the service name (the project name, which is CustomerOrder in 
our case), the schema name (the schema used in the project), and the port name (the Send or 
Receive ports of the project). Fig.Biz-7.4 displays the message report of the 
CustomerOrderFlatFile schema used in the CustomerOrder project. 


You can use the Find Message technique by following these steps: 


1. Click Start>All Program > Microsoft BizTalk Server 2006 Health and Activity Tracking to 
open the Health and Activity Tracking window, as shown in Fig.Biz-7.1. 


Wii Health and Activity Tracking? @ 2/777) /7/ 

File Reporting Queries Tools Help = 
The Health and Activity Tracking (HAT) tool provides features for reporting. analyzing. and debugging data and rnessages that are archived in 
the BizTalk Tracking databases 


For repoiting, analyzing, and debugging live data. use the BizTalk Administration Console To use the HAT teatures of the BizTalk 
Administration Console. select BizTalk Server Administration from the Start Menu. and then select the BizTalk Server group that you want to 
examine ‘ou can either use the included queries that appear on the Group Hub page. or select the New Query tab to create custom queries 
and reports 


For examining archived tracking date, the HAT tool provides the following menus 
Reporting 
Find Message enables you to select a schema and search based on tracked promoted properties 


S Metres and Message Metrics enable you to access OLAP cubes through pivot table wews. ‘You must first process your OLAP 
cu 322 documentation tor the steps to do this 
Use Query Builder to create quenes by dragging and dropping tables and fields into your T-SQL query ‘ou can save custorn quenes as 
files and then access them fram the Quenes menu 


You ¢ 


right-click an item in the Results listta examine the Message Flow or use the Orchestration Debugger ta step through your 
| Orchestration shape-by-shape 


| EDI technology 
EDI technology in Microsoft BizTalk Server 2006 was develaped by Covast Corporation. Far additional information on EDI see 
http Mia covast.com 


Fig.Biz-7.1 
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2. Select the Find Message option from the Reporting menu. This displays the Find Message 
View screen, as shown in Fig.Biz-7.2. 


Gi Find Message View 


File Reporting Queries Tools Help 


>> ee Schema... ee ii 4 eee acts a pe ges oe 
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3. Click the Schema button, as shown’ in_ Fig.Biz-7.2, and select the 
http://CustomerOrder.CustomerOrderFlatFile schema from the Schema Selection dialog 
box, as shown in Fig.Biz-7.3. 


i Schema Selection " 


Select a schema ta search for: 


Target Name Space ee : 
‘http: //CustomerOrder. CustomerOrderFlatF ile 
http: /CustomerOrder CustomerOrderS chema Gree ervice 
http: “schemas. microsoft.com/BizT alk/2003/Any Foot 


ae Biz- 7.3 


In our case, Fig.Biz-7.3 displays only two schemas of the CustomerOrder project (apart from the 
default schema created by BizTalk Server), which we created in Chapter 4. 


4. Select the CustomerOrderFlatFile schema from the Schema Selection dialog box and click 
the OK button to open the Find Message View screen, as shown in Fig.Biz-7.4. 
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Selecting the CustomerOrder.CustomerOrderFlatFile schema (Fig.Biz-7.3) activates the OK. 
button. 


2lBi x 


Reporting Queries 


| 
| 


Lint 


Message + Semice » Senicelnstance/SemceName 
» (1BC4F661-1 (FBSECF= Mic 
{DAQB1198- (F BBECF= 
(DADB1198- {ASAC3C7 ¢ 


Talk DefaultPipelines. XMLTransmit http //CustomerOrder CustomerOrderSchema#OrderSernice Receive 
yerOrder CustornerQiderOrchestration — http //CustomerOrder CustomerOrderScherna#OrderSemice Send 
stomerOrder CustornerOrderOrchestration http //CustornerOrder CustornerOrderScherma#OrderService Receive 

oft BizTalk DefaultPipelines XMLRecewe http //CustamerOrder CustomerOrderSchema#OrderSerice Send 

of BizTalk DefaultPipelines. XMLTransmit http //CustomerOrder CustomerOrderSchema#OrderSemice Send 

= XMLTransmit http //CustomerOrder CustomerOrderScherna#OrderSemice Receive 
hestration http /‘CustamerOrder CustamerOrderSchema#OrderSemice Send 
stration http //CustomerOrder CustomerOrderSchema#OrderService Receive 
ALReceive htip //CustamerOrder CustomerOrderSchema#OrderService Send 

oft BizTalk DefaultPipelines XMLTransmit http //CustomerOrder CustomerOrderSchema#OrderSemice Send 
TE eee eae Se eae eee = » 


Fig.Biz-7.4 


To know more about the CustomerOrderService schema, refer to the ‘Adding a Flat File Schema’ 
section of Chapter 4. 


5. Now, click the Run Query button (Fig.Biz-7.4). This will display a list of schema messages 
sent or received during the dates specified in the From and Until drop-down lists 
(Fig.Biz-7.4). 

6. The list of schema messages shown in lower part of the Find Message View screen 
(Fig.Biz-7.4) are those that we recently used in the CustomerOrder project. Right-click any 
message whose message flow you want to view and select the Message Flow option from the 
context menu to open the Message Flow screen (Fig.Biz-7.5). Details of the selected message 
are displayed on your screen (Fig.Biz-7.5) 


BE Message flow = 3 

File Reporting Queries Tools 
Message Ficw 

a Service Name Microsoft BizTalk Delault Pipelines XML Tranemit 


Help 


2 Message Activity for the Sernce Instance 


Fig.Biz-7.5 
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The Query Builder Technique 
You can use the Query Builder View technique if you want to retrieve only specific information 
about a message, such as its size and state, unlike the Message Flow View technique, in which 
all information of a message is displayed. Take the following steps to view a message in Query 
Builder View: 


iP 


Open the Health and Activity Tracking tool and select the Query Builder option from the 
Reporting menu. The Query Builder View screen appears, as shown in Fig.Biz-7.6. 


{Bi Query Builder ¥iew 2 _-jO} x} 
File Reporting Queries Tools Help y oe 

Type your query in the night panel ‘You may drag field and namespace names fram the letttree Hide Query : 
OL Views 30L Query 

#4) 2) SericeMetrics 

&! 3) MessageMetrics 

Run Query 
ae. 


Fig.Biz-7.6 
Write the query in the SQL Query box if you are familiar with its syntax or create an SQL 
query by simply dragging the various fields in the ServiceMetrics or MessageMetrics nodes 
onto the SQL Query box. 


Message Metrics or Service Metrics node is used to view message details in different ways 
according to the fields available in these nodes. Various fields available in these nodes are as 


follows: 

Q Instance/State: This field shows the current state of the message instance. 

Q Servicelnstance/State: This field shows the status of a message, such as either Completed or 
Terminated. 

Q Start time: This field shows the time the orchestration or pipeline started. 

Q_ End time: It shows the time the orchestration or pipeline was completed. 

Q Duration: This field shows the time it took for the entire operation to be completed. 

In our case, we have selected only the Servicelnstance/State field in the Query Builder 


technique, shown encircled in Fig.Biz-7.7. This means that we are viewing only those messages 
whose status is completed (that is, only successful message will be displaved). 


2. 
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After writing the query, click the Run Query button, as shown in Fig.Biz-7.7. This displays 
the result of the query in the lower portion of the Query Builder View screen (Fig.Biz-7.7). 
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Now, if you want to view the message flow of an __ orchestration, 
for example CustomerOrder.CustomerOrderOrchestration, simply — right-click the 
CustomerOrder.CustomerOrderOrchestration row and select the Message Flow option from the 
context menu. 


Message Count in Past Week Technique 


Let us now use HAT to display the number of messages received or sent in the past week as well 
as the number of message transmission failures that have occurred in the period. To do this, 
follow these steps: 


1. Select the Message count in past week option from the Queries menu. A security warning is 
displayed the first time you open a query, as shown in Fig.Biz-7.8. 


Shaw Query | 2 
Run Query 


Wi Heatth and Activity Tracking 


Health and Actvily Tracking is about to load 9 saved quey 4 
containing an SOL siatement It pinot safe te rary quenes [rom untrusted 


souress. 
lick Yea to load and tun the query, click No 'o load without mnning’ 
the quety, or chak Cancel to de nething: 


Fig.Biz-7.8 
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2. Click the Yes button (Fig.Biz-7.8). This will display the number of received, sent or failed 
messages in the past seven days on your screen, as shown in Fig.Biz-7.9. 


siB) x! 
Show Query a 
Run Query a 
w more details an an entry nghtelick the c=ll and select Orchestration Debugger o' Message Flow (requires 
ee (| eee a a 
| 
A 
ss sees aoe = =| 


Fig.Biz-7.9 


The Message Counts Technique 


Use the Message Counts technique to show the number of messages sent and received in the last 
1, 2, 7 and 14 days in a table. To view messages by the Message Counts technique, select the 
Message Counts option from Queries menu. The Message counts screen appears, with the 
number of sent or received messages against the specified days, as shown in Fig.Biz-7.10. 
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(ULES 2) See eee ape Se) Le eens 67 Se) 
{ 
j 
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} 
| 
| 
i 
ra 
i} 
! 
Fig.Biz-7.10 
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The Message Received in Past Day Technique 


You can also view all the messages that the BizTalk application receives in the last 24 hours. To 
perform this operation, simply select the Message Received in Past Day option from the Queries 
menu. The Messages received in past day screen appears, as shown in Fig.Biz-7.11. This screen, 
for example, displays a list of all messages received on 24/10/2007. 


fii Query Builder View : Messages.received in past day ee lot xi! 
File Reporting Queries Tools Help 


‘You may view current query by expanding this control Show Query i a | 


Run Query | 


jetails on an entry, mghtclick the cell and select Orchestration Debugger or Message Flow 
nn) 
Hnce eee ae ‘Event/Direction > be ~ Timestamp a q > Event/Adapter = - Event/U IRL a - Event/Dh 

> Unparsed Interchange Receive 0/24/2007 4:38:32.170 PM FILE ©.\CustomerOrder\receive\* xm 
Unparsed Interchange Receive 0/24/2007 4:56:50.982 PM FILE C\CustomerOrderreceive™. xml 
Unparsed Interchange Receive 10/24/2007 4:36:27 .4982 PM FILE CA\CustomerOrderreceive® xml 
Unparsed Interchange Receive 10/24/2007 4:°32:58.937 PM FILE C'\CustomerOrderreceive\* xml 
Unparsed Interchange Receive 0/24/2007 4:30:53.500 PM FILE C\CustomerOrderveceive” xm 
Unparsed Interchange Receive 0/24/2007 4:16:12.419 PM FILE CA\CustomerOrdervreceive\* xin 
Unparsed Interchange Receive 0/24/2007 4:17:58 482 PM FILE C\CustomerOrderreceive™ xin 
Unparsed Interchange Receive 10/24/2007 4:17°28.826 PM FILE CA\CustomerOrderreceive\* xr 
Unparsed Interchange Receive 0/24/2007 4:17:05.327 PM FILE C \CustomerOrder\receive\* xml 

L Unparsed interchange ss Receive _ 10/24/2007 4:16:53.110 PM FILE | c\CustomerOrderreceivel™ xml | 

] 

| 

S| 

1) BO ee a eae fad a | 

Fig.Biz-7.11 


Similarly, to view the messages sent in the last 24 hours, select the Message Sent in Past Day 
option from the Query menu. You can also view options including Most recent 100 service 
instances, Most recent 100 services terminated with errors, Recent service instances, and 
Services running longer than 24 hours by selecting the respective options from the Query menu 
of the Health and Activity Tracking tool. 


After selecting the Message Counts and Message Received in Past Day options, the warning 
message appears on your screen as shown in Fig.Biz-7.8. Just click the OK button to proceed. 
You can also debug the application by using the Orchestration Debugger, which you can access 
by right-clicking the message (in HAT) and selecting Orchestration debugger from the context 
menu. You also need to set the breakpoints in the Orchestration Debugger for debugging the 
Orchestration. Breakpoints can be set by using the F9 key on the keyboard. 


You now know about the various views in the Health and Activity Tracking (HAT) tool that you 
can use to monitor as well as check the various components of the BizTalk application. With 
this, we move to a new section in which we will discuss the common adapter errors in BizTalk 
Server 2006 and learn how to troubleshoot them. This is important as information is transferred 
from one location to the other through adapters. 
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Common Adapter Errors in BizTaik Server 


Accessing data using the BizTalk Server may sometimes display error message such as “File 
adapter not found” or “Receive location is not accessible”. These errors occur when some 
service related to the BizTalk application is not running or the wrong path is specified in the 
receive location at the time of BizTaik messaging. You need to have some idea of the common 
errors associated with adapters in BizTalk, along with their possible causes and solutions. Table 
7.1 lists some of these errors and also provides ways to troubleshoot them. 


Tabie 7.1: File Adapter Errers 
Error 


File receive adapter is not able 
to access the specified receive 
iocation. 


Files at the receive location 
cannot be read by the File 
adapter. 


rile send adapter has problems 
in sending messages. 


Cause 


Receive adapters specified 
path does not exist. 


Adapter is unable to read or 
write the file at the specified 
location due to restricted 
rights. 


File names at the receive 
location contain more than 256 
characters. 


Files at the receive location 
are system files. 


File receive adapter does not 
have permission to read or 
write the received file. 


File names contain more than 
256 characters. 


File send adapter is unable to * 
access the directory from: 


which files need to be sent 
because the directory at the 
specified location does not 
exist. 


File send adapter does not have 
the permission to write the file 
on the destination location. 


File to which the message 
needs to be written at a 
destination location is read- 


Solution 


Give the existing path or 
create the specified path 
location. 


Ensure that the path of the 
file is accessible so that it 
can read or write from the 
specified receive location. 


Ensure that the file names in 
the receive lecation do not 
contain more than 256 
characters. 


Ensure that the file is net a 
system file. 


Ensure that the file receive 
adapter has the read/write 
permission. 


Ensure that the file names de 
not contain more than 256 
characters. 


Change the path of the 
specified location or create 
the directory at that location. 


Assign the write permission 
to the file to which the 
message is to be written 
through the File send adapter. 


Assign write permissicns for 
the file at the location to 
which the message is to be 
written by the File send 
adapter. 
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Table 7.1: File Adapter Errors 


Error 


Cause 


only. 


File to which the message 
needs to be written at a 


Solution 


Niake sure that the file at the 
specified location is not a 
system file. 


destination location is a system 
file. 


The Allow cache on write 
property of the File send 
adapier is set as False by 
default. 


Change the Allow cache on 
write property to True. 


File send adapter’s message 
sending speed is very slow. 


Files from the specified location File send adapter is unable to Map a network drive to the 

cannot be stored or accessed, set the user name and location at which the files are 

as these require a username password. to be stored, set the 

and password. username and password, and 
then use the mapped network 
drive in the Send port 
address. 


You now have a general idea of common adapter errors encountered in the BizTalk application 
and also know how to fix them. Next, we discuss common errors that may crop up while 
installing, configuring and administering BizTalk Server. We will also talk about the errors you 
may encounter while implementing the SSO service. 


Error Handling in BizTalk Server 


Errors can occur at various levels of BizTalk Server. These may come up at the time of: 
Q installing BizTalk Server 

Q Configuring BizTalk Server 

Q Implementing the Enterprise Single Sign-on service 


Q Administrating BizTaik Server. 
Let us now discuss these errors in some detail, along with their solutions. 


Handling Errors during BizTatk Server Installation 


Installation errors can occur when the software requirements are not met fully while installing 
BizTalk Server 2006 onto your system. !nstallation errors can also occur if another application or 
service is using the software required to install BizTalk Server. Table 7.2 shows the errors that 
can occur at the time of installing BizTalk Server, along with their solutions. 
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Tabie 7.2: BizTalk Server Installation Errors 
Error 


Visual Studio .NET is unable to open during the 
installation of BizTalk Server. 


Several Dynamic Link Library (DLL) files are not 
loaded properly when installing BizTalk Servet 
using Remote Desktop Terminal Services. 


User is unable te install Bizfalk Server due to 
the following error message: 


Error 1303: installer has insufficient 
privileges to access this directory < Bizfalk 
Install directory>\httpreceive. The installation 
cannot continue. Log on as administrator or 
contact your system administrator. 


The 


User is unable to install Bizfalk Server due to 
the following error message: 


“Unable to connect to registry on server 
(machineName), or you are not a member of the 
OLAP Administrators group on this server" 


Solution 


Close the Visual Studio .NET window. 


Log out of the terminal session ‘remote desktop 
computer), and log on again after you install and 
configure BizTalk Server. 


Te solve the error, do the following: 

1. Restart HS (Internet Information Services). 

2. Delete the BizTalk Server's installation folder. 
3. Run the BizTalk Server Setup again. 


Create the user account used by BizTalk Server to 
connect SOL to the OLAP administrator group. !f the 
problem persists, you need to reinstall SQL Server 
and add the user acceunt to the OLAP administrator 


group. 


Handling BizTalk Server Configuration Errors 


Errors can also occur while configuring the BizTalk Server on the system. The BizTalk 
Configuration Wizard helps you to configure the BizTalk Services required to run the BizTalk 
Server. Table 7.3 shows the errors that can occur at the time of configuring BizTalk Server along 
with their probable causes and solutions. 


Table 7.3: BizTaik Server Configuration Errors 


Error Cause Solution 
User is not able to This error occurs when the user : Ensure that the domain 
configure Biztalk Server on specifies the local account for the” account is specified in both 
a domain controller. BizlalkServerApplicaticn host or the hosts. 

the  BizTalkisolatedHost host 

instead of the doman account. 
The Rule Update and The ports used by BizTalk Server for Cicse the application or 


these services are used by another 
application or service. 


Biztalk Message Gueuing 
services are not starting or 
configuring properly. 


service that is using the ports, 
restart the computer, and run 
the BizTalk Configuration 
Wizard again. 


Restart Windows 
Management Instrumentation 


The following 
message appears 


error 
at the 


Mceurs when you open Human 
Workflow Services Console before 
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Table 7.3: BizTalk Server Configuration Errors 


Error 


time of configuring BizTalk 

Server: 

The selected server does 

not exist or does not have 
a valid Human Workflow 

Services instailation. 


BizTalk Server is not 


connected with Web 
Services. 

Windows Management 
Infrastructure (WMi) is 


unable to create the SQL 
login. 


Cause 


the process of configuring Biztalk 
Server is compieted. 


Occurs when you use the SQL 
Server 2000 Desktop Engitie 
(MSDE) instance for BizTaik Server 
databases, and ithe TCP/IP 
protocols are not enabled. 


The Biztalk Configuration Wizard 
does not disable the jaca! Windows 
group option on which you wast to 
configure BizTalk Server in the 
domain controller. ; 


Handling Single Sign-On Service Implementation Errors 


Solution 
(VR. 


enable the TCP/AP protecois 
by running the following 
command at the command 
prompt: 

\Program Files\Micresoft SQL 
Server 
\80\Tools\Bin\svrnetcn.exe 


Change the name of the 


NTGroupName from 
<ComputerName>\GroupNa 
me to 


<DomainName>\GroupName 
it the acm_Host table, which 
iS present in BizfaikMgmtDB 
database Manager. 
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The Enterprise Single Sign-On (SSO) service in BizTalk Sever enables a user fo log on to multiple 
applications by using a single user name and password. Table 7.4 shows the errors that can 
occur at the time of implementing SSO in the BizTalk Server, along with their probable causes 


and solutions. 


Table 7.4: Enterprise Single Sign-On Service implementation Errors 


Error 


The following error message 
appears when a user tries to 
connect to the remote SSO 
server by using the ssomanage 
- dispiayaap <appiication 
name> command: 

ERROR: OX8007068A: 
The RPC © server is 
unavailable 


Cause 


Occurs when users enter 
incorrect server information or 
when the SSO service has 
failed to run on the remote SSO 
server. 


Solution 


Make sure that the SSO 
service is sunning on the 
remote SSO server. 
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Table 7.4: Enterprise Single Sign-Gn Service Implementation Errors 


Error Cause Soiution 
Ensure that the administrator 
account associated with the 


affiliated application is valid. 


The application administrator 
account asseciated with the 
affiliate application is not valid. 


User is unable to access an 
affiliate application. 


Provide the location of the 
SSO server on BizTalk Server 
Administration Console. 


Biztalk Sever fails to connect The SSO server is not available. 


to the SSG server. 


Run the ENTSSO service under 
a valid SSO administrator 
account and restart the 
service. 


The ENTSSO service is not 
running uader a valid account. 


User is not able to start the 
ENTSSO service 


Handling Errors during BizTalk Server Administration 


Administering BizTalk Server is required for managing the BizTalk Services and its applications. 
You can manage or administer BizTaik Sever by using BizTalk Administration Console. Table 7.5 
lists the various errors that can occur while administering BizTalk Server, along with their 
probable causes and solutions. 


Table 7.5: Bizfalk Server Administration Errors 


Error 


User is unable to delete 
a host from the 
computer running 
Biztalk services. 


User is unable to start a 
host instance on the 
remote computer. 


User is unable to delete 
a MessageBox datahase 
from ithe computer 
running BizTalk services. 


Cause 


User is not a member of the 
Windows Administrator 
group on the local computer. 


User enters invalid details in 
the service account for 
which BizTalk Server is 
running or the service 
account is not granted 
service rights. 


The cache refresh interval 
has not expired. 


MessageBox database 
contains incomplete service 
instances. 


MessageBox datapase 
contains unprocessed 
tracked data. 


Solution 


Make the user a member of the 
Windows Administrator group. 


Grant the user service rights for this 
service account on the remote location. 


Disable the new message publication 
from the MessageBox database and 
wait until the cache refresh interval 
expires. 


lf the MessageBox database has 
suspended service instances, locate 
these instances using the Health and 
Activity Tracking (HAT) tool and 
terminate them. 
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Table 7.5: BizTalk Server Administration Errors 


Error Cause Solution 


lf the MessageBox database cuntains 
unprocessed tracked data, execute the 
following seripz: 

Cscript ForceDeleteMsgBox.vbs < 
MessageBox Database name> 


User is unable to delete User deletes a host instance Locate the services related to BizTalk 
database objects from the computer running Server on the computer running Biztalk 
associated with a host BizTalk services and then services and stop the services. 
instance. tries to delete the 

associated database 

objects. 
User is unable to start Occurs when the user Add the end user as a member to the 
the BizTaik reinstalls or reconifigures Windows Administrator group. 
Administration Console. BizTalk Server. After 


reinstalling or reconfiguring, 
the end user whe wants to 
start the BizTalk 
Administration Console is 
net the member of the 
Windows Administrator 
group on the iocal computer. 
The user reinstalis or 
reconfigures Bizlalk Server 
and starts the  BizYaik 
Administration Console 
without becoming a member 
of member of the Windows 
Administrator group on the 
loca! computer. 


This concludes the chapter. What follows next is a short summary of the chapter. 


Summary 


In this chapter, you have learned how to use the Health Monitoring tool (HAT) to check and 
monitor the health of BizTalk Server 2006. You have also learned about the common errors in 
the BizTalk Server related to adapters as well as those encountered during installation, 
configuration and administration of the BizTalk Server. 


By now, you must have a good knowledge of the various components of BizTalk Server 2006 
and feel comfortable enough to develop BizTalk applications of your own in .Net. You are also 
familiar with business rules and policies and know how to create them through the Business Rule 
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Composer. Moreover, you have a good background of B2B processes that will help you to 
understand how business is conducted in today’s competitive environment. Last but not the 
least, you know the common errors that you may face while working with BizTalk Server. We 
hope that you will use the knowledge you have gained from this book profitably to boost your 
career or professional goals. Best of luck! 


7 
press Bi; 


Microsoft: 


BizTalk Server 2006 


Manage Your BizTalk Server 


Connect to an existing group 


Learn About BizTalk Server 2006 
Getting started >] Administert 


Planning and implementation Operatie 


Pick a Help Topic 
©) Connect to an existing group 
©) Create 4 receive location 


1) Create a receive port 


Community 
Microsoft BizT all 


Developing BizTalk 2006 Applications 


Developing BizTalk 2006 Applications IN SIMPLE STEPS is a 
book that helps you to develop Custom BizTalk Applications 
in a precise and complete way. It offers the reader a cutting 
edge in the field of BizTalk 2006.,.An easy to understand 
style, lots of examples to support the concepts, and use of 
practical approach in presentation are some of the features 
that make the book unique in itself. The text in the book is 
presented in such a way that it will be equally helpful to the 
beginners as well as to the professionals. 


The book covers: 


® Features of BizTalk 2006. 


mn Usage of BizTalk Orchestration for performing any 
business process. 


mu ~=The development of Custom BizTalk Applications. 


m Usage of Schemas, which includes simple and flat file 
Schemas. 


=m How to do mapping of XML files. 


a Implementing business rules using Business Rule 
Composer. 


# Testing Deployed Custom BizTalk Applications using 
BizTalk Server 2006 Administration Console and 
BizTalk Explorer. 


=m Business process overview. 


m Troubleshooting and monitoring BizTalk Applications. 


MTNTy || Get 


dreamal rolech 


Published by: 


ISBN 10: 61-7722-857-9 


Dreamtech Press. 

19-A, Ansari Road, Daryagani, 

New Delhi-110002 

Tel.: 91-11-23284212, 23243075 

Fax: 91-11-23243078 : 
Email: feedback@dreamtechpress.com 


| 


617 7"228571 


ISBN 13: 974-81-?7?22-85?-1 


il 


aSRS 


sgy- ACV 


errr Tri ne IE | 


"SPECIAL INDIAN PRIC 


Rs. 179/-, 


International Price $9.99 


